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HOW TO 


How to Find Information in This and Other 
PLAN Series Manuals 


This manual is designed to provide a description of those PLAN 
File Server functions that are specific to the IBM Personal Com- 
puter DOS 2.00 through DOS 3.10 environments. 


For an introduction to the network, read the General Information 
Manual. 


For general information pertaining to shared hard disks on the 
network and network commands issued to them by worksta- 
tions, read the PLAN Series Network Command Reference 
Manual. 


PLAN Series networks support Apple, IBM PC, and compatible 
workstations running under a variety of operating systems. 
Some network facilities are available only in the IBM PC DOS 
environment. Among them are 


Startup using menus Section 1.2 
Secondary (Shadow) file server Section 2.8 
Virtual and spooled printing Section 3.2 
COUNT (network activity) utility program Section 5.3 
CARDCHK (network interface card) test utility Section 5.6 
PLANPak business application package Section 6.1 


These facilities are described in this manual. 


Network installation and configuration are described in the Phy- 
sical Planning Manual, the PLAN 3000 (or 4000 or 5000) Quick 
Installation Guide, the Network Installation Reference Manual, 
and the Print Server Installation and Operation Manual. 


The PLAN Series General Index indexes the contents of seven 
core PLAN Series manuals. 


A bibliography of system manuals and guides appears at the 
end of this guide. 
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This Manual 


The material in this document applies to Version 2.3 of the 
PLAN File Server software 


Chapter 1 of this manual explains how to enroll a first-time user 
on the network using the NEWUSER utility, and how to config- 
ure workstations for “customized” startup. For users of PLAN- 
Pak II™, the Nestar package of application programs, additional 
startup information is found in Chapter 6. 


Chapter 2 explains how to share network disks. A general dis- 
cussion of disk sharing network commands, true for all com- 
puter operating system environments, is found in the PLAN 
Series Network Command Reference Manual, which can be 
used for reference. The Shadow File Server is also discussed in 
detail in Chapter 2. 


Chapter 3 discusses the print server and two shared printing 
options, the Virtual Printer and the Print Request Program 
(NPRINT), available on the network. Section 3.4 outlines how to 
use a local printer. Section 3.5 discusses PRINTQ, a program 
run at an IBM PC DOS workstation, which tracks print requests. 


Chapter 4 offers information on accessing the network from 
Pascal, Cobol, Compiled BASIC, and C programs, and from 
other languages. Multi-user applications are also discussed. 


Chapter 5 discusses utility programs provided on the network: 
the STARTUP utility executes a file of commands on the 
workstation’s default volume at initialization time (supplements 
AUTOEXEC.BAT). The TCOPY utility allows workstations to 
copy text files from one microcomputer/operating system 
environment to another. The COUNT utility is a network monitor 
program that tabulates network activity. The NEST utility allows 
workstations to direct file server response codes to the DOS 
condition ERRORLEVEL instead of to the workstation console 
screen. The SETPRINT utility allows workstations to specify 
print server header items and write them directly to a virtual 
printer, or to a file for later use. The NWCMDS utility allows 
access to any file server or the virtual printer from within any 
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program environment via a scrolling window CARDCHK is 
used to test Network Interface Cards (NICs) and diagnose prob- 
lems. 


Chapter 6 contains information on PLANPak li, a starter library 
of application programs (SuperCalc3, SuperWriter, 
DATASTORE:LAN, and LAN:MAIL MONITOR) distributed with 
the PLAN Series software. Due to a licensing agreement, 
SuperCalc3 and SuperWriter can be used concurrently by 
no more than 4 persons without additional license fees. 
DATASTORE:LAN and LAN:MAIL MONITOR can be used 
concurrently by an unlimited number of persons. However, 
no more than 5 people can concurrently share the same 
DATASTORE:LAN database (file). An upgrade is available 
for DATASTORE:LAN which permits up to 12 concurrent 
users of a single database. 


Also provided are instructions on accessing and using the appli- 
cation programs, saving and printing data from application pro- 
grams, mounting data volumes automatically at startup, and 
adding additional application programs to an applications menu. 


Additional information is provided in four appendices. 
Appendix A contains a list of file server commands. 


Appendix B provides instructions on how to upgrade your net- 
work from DOS 1.1 to 2.00, 2.10, 3.00, and 3.10. Software 
upgrades are also discussed in Appendix B of the PLAN Series 
Network Command Reference Manual. 


Appendix C contains a list of DOS files distributed on the 
shared library volume /MAIN/LIB/IBMPC/DOS. 


Appendix D provides a list of Level 4 error codes, the transla- 
tion of each code, and what to do upon receiving an error code. 


We welcome criticisms and suggestions. Forms for reporting 
program errors and documentation errors or inadequacies are 
provided at the back of this manual. 
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if you want to... 


Customize your workstation 
Startup 


Get more work space on the 
network hard disk 


Read about “network” commands 
that allow you to create, access, 
and delete space on shared 
network disks 


Use a backup “shadow” file 
server 


Print a document 
Change printer margins 


Have your name printed on the 
cover page 


Use the COPY command to print 
on a network printer 


Use both local and network 
printers 


Prevent someone from reading 


or modifying your data 


Read about network hardware 
installation 


Read about file server 
facilities 


System manager tasks 


vi 
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Chapter 1 


Starting Up 


1.0 Introduction 


This manual assumes that you are familiar with the IBM Per- 
sonal Computer, with DOS 3.10, and with your network as 
described in the PLAN Series General Information Manual and 
the PLAN Series Network Command Reference Manual. 


This manual also assumes that you are using DOS 3.10. How- 
ever, DOS 2.00, DOS 2.10, DOS 3.00, and DOS 3.10 are com- 
patible, and the information in this manual is true for all three. 


This manual assumes that you are using the IBM PC computer, 
the IBM PC XT computer, or the IBM PC AT. 


Finally, note that PLANPAK II™ requires a computer with 256K 
of memory in order to run the application program LAN:MAIL 
MONITOR and 320K of memory to run DATASTORE:LAN. 


This chapter discusses: 


real and virtual boot diskettes (Section 1.1) 
starting up; the BOOT program (Section 1.2) 

setting up a profile volume (Sections 1.3-1.9) 
network-bootable diskettes (Sections 1.10-1.12) 


1.1 Real and Virtual Startup Diskettes 


Standalone IBM PC users start up ("boot") their workstations by 
inserting a DOS diskette in one of their real disk drives. The 
diskette must contain DOS as well as any necessary special 
device drivers. 


Network users can boot in the same way or by accessing a vir- 


tual boot diskette mounted on drive A: or C:. However, the net- 
work boot diskette, real or virtual, must contain the network 
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driver, NETWORK.SYS, as well as a CONFIG.SYS file, and 
DOS itself. 


Creating virtual diskettes is discussed in Sections 2.0 and 2.4 of 
this manual. Configuring network boot diskettes is discussed in 
Sections 1.10 through 1.12 of this manual and in Appendices G 
and H of the PLAN File Server Installation and Operation 
Manual. 


As explained in the following sections, network users can have a 
diskette booted automatically at startup, specify the diskette that 
they want booted each time that they start up, or have a startup 
menu displayed. For more information on accessing the startup 
menu see Section 6.1. 


1.2 Starting Up 


Boot a workstation by powering on the computer or, if it is 
already on, by pressing the <Ctrl>, <Alt>, and <Del> keys 
simultaneously. If there is a network interface card installed, a 
network BOOT program will load into the computer from the file 
server and execute automatically. 


At power on the network interface card in the computer will do a 
selftest. If one of the messages 


D300 ROM net <bn> net <nr> 


appears, the interface card is defective and should be replaced. 
if the computer has no local drives, these messages may be 
overwritten rather quickly. 


The message "net <du>", which can appear at startup or while 
the computer is being used, indicates that another station on the 
network has the same address. This is an incorrect network 
condition and must be corrected immediately. 


1-2 


STARTING UP 


Upgrading Early IBM PCs 


Some early IBM PC machines have an early model of the ROM 
BIOS chip that accompanies machines with 64K bytes of RAM 
on the system board. The early ROM BIOS chip does not permit 
access to the network via the BOOT program. Such machines 
must be upgraded with a new ROM BIOS chip or must boot 
from diskette to access the network. 


The serial numbers of IBM PCs originally manufactured with the 
old BIOS modules are as follows: 


Marketed in US and Canada: Serial #0300960 or lower 


Marketed in World Trade, Manufactured in US: Serial 
#0463499 or lower 


Marketed in World Trade, Manufactured in UK: Serial 
#0000755 or lower 


If you are in doubt about which BIOS module is installed in a 
computer, you can determine the date when the BIOS module 
design was completed by keying in the following 4-statement 
BASIC program: 


10 DEF SEG =&HFO000 

20 FOR X = &HFFF5 to &HFFFF 
30 PRINT CHR$ (PEEK (X)); 

40 NEXT X 


Entering the RUN command will cause the date to be printed 
out. A date later that 10/19/81 indicates that the BIOS Update 
Kit is not needed. A date of 10/19/81 or earlier indicates that a 
BIOS update must be installed for the computer to be able to 
boot from devices other than a floppy disk (that is, from a hard 
disk or from the network via the network interface card). The 
BIOS upgrade kit is available from IBM as part #1501005. 
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1.2.1 Logging on for the First Time 


Two Methods: 


(1) Use the "Newuser" utility (Section 1.11.2.1). 


This utility creates a personal work volume for the new user 
and configures the workstation so that DOS is loaded and 
the work volume is made available automatically at power 
on. 


(2) Use the information in the rest of this chapter, in Sections 
2.0 and 2.4 of this manual, and in Appendix C of the PLAN 
File Server Installation and Operation Manual to create a 
personal work volume (or volumes) for the new user and to 
configure the system so that DOS is loaded and, optionally, 
menus and application programs are made available to the 
user at startup. 


1.2.2 The BOOT Program 


The network BOOT program, which loads into the computer at 
power on, is provided to allow you to tailor the startup process 
at any workstation to suit the user’s needs. 


The BOOT program will first search the file-server hard disk for 
a network virtual volume, of Type=T (Text), called a station pro- 
file (see Summary, page 1-10). 


If the profile volume is found, BOOT executes any startup com- 
mands in it. You will be setting up one or more profiles. Setting 
up a profile is discussed in Section 1.3. A profile volume and the 
Startup commands that it contains individualize a station. The 
volume is keyed to the station address of the machine, and the 
address is unique on the network. 


Usually one of the profile startup commands will be 


MOUNT <pathname>,A:,RW 
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or 
MOUNT <pathname>,C:,RW 


where "pathname" is the network pathname of the boot volume, 
if virtual. A: or C: is the drive letter upon which the boot volume 
is to be mounted. 


The final command in the profile will then be 
BOOT A: or BOOT C: 


where A or C is the drive letter, real or virtual, containing the 
boot volume. 


BOOT will then boot the volume, loading DOS into the computer 
and executing it. DOS will go through its normal startup 
sequence and execute AUTOEXEC.BAT, if present on the 
volume. 


If no station profile is found, the BOOT program will execute the 
startup commands found in the default profile. 


If no station or default profile exists, BOOT will prompt for a dif- 
ferent profile pathname: 


File Server: $NN 
Station: $nn 
Boot Profile ? 


Type in the desired profile pathname. ($NN and $nn are used to 
signify that the file server and user station have different 
addresses. The capitalization has no other significance.) 


lf (drive letter): is entered, the station will boot directly from the 
real drive specified. This allows booting from a real floppy 
diskette or hard disk. 


For information on how the BOOT program interacts with 
networked application programs, see Section 6.6. 
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1.2.3 Starting Up from a Menu 


A menu can be placed in any profile and displayed each time at 
startup. Up to ten menu items can be defined. Menu items are 
then selected at startup by pressing keyboard function keys 
(<F1> through <F10> and <Esc>). 


Menu items can be displayed in various colors and/or 
highlighted by using simple escape codes. A menu item can 
also be selected to execute automatically after a time delay. 


The BOOT program will first execute any commands in the 
profile’s prolog (the portion of the profile that precedes the 
menu). Then the menu will be displayed. Finally, if the user 
returns to the profile by pressing the ~Esc> key in the menu, 
any commands in the profile’s epilog (the portion of the profile 
that follows the menu) will be executed. 


For example, user Fred might see a menu at startup like this: 


Welcome to Fred's workstation! 
F1 Boot into DOS work disk one 


F2 Boot into DOS work disk two 


F3 List any volumes on file server $FE 


F4 Chain To Mary’s Profile 
F5 Enter new profile 
Esc Enter commands from the keyboard 


Please select 





(The profile that produces this menu is found in Section 1.4.8.) 
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Pressing the F1 function key will cause BOOT to mount Fred's 
DOS work disk one on drive C and boot it. No further menu 
items can then be selected. 


Pressing the F2 key will cause Fred's work disk two volume to 
be booted on drive C. No further menu items can then be 
selected. 


Pressing F3 will cause BOOT to list all of Fred’s volumes on the 
file server $FE, ending with the prompt “Press any key to return 
to Menu". Boot will then wait for a key to be pressed before 
redisplaying the menu. The user can then make another menu 
selection. 


Pressing F4 will cause BOOT to search for a profile with the 
pathname 


HSYSTEM/PROFILE/MARY 


and execute the commands found in it. If MARY’s profile cannot 
be found, BOOT will return to the menu. 


Pressing F5 causes BOOT to prompt for.a profile pathname. 
Any commands in that profile will then be executed. 


Pressing <Esc> will cause BOOT to return to the profile in 
which the Menu is defined and to execute any command lines 
that follow ENDMENU. 


If BOOT encounters an error while executing a network com- 
mand associated with a menu item, the command and error will 
be displayed, followed by 

Abort, Retry, Ignore? 


Typing “A” for Abort will cause BOOT to display the menu again 
for some other selection. 


Typing “R” for Retry will cause BOOT to reissue the network 
command. 
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Typing "I" for ignore will cause BOOT to go on to the next com- 
mand defined by the menu item. 


The menu display is continued until one of the following occurs: 
— a BOOT command causes a volume to be booted 


— a BASIC command (Section 1.4.3) causes BOOT to execute 
the resident BASIC in the workstation (if available) 


— a PROFILE <pathname> command chains to a different pro- 
file 


— a PROFILE command causes BOOT to prompt the user for a 
new profile 


— the <Esc> menu item quits the menu and returns to the pro- 
file at the line following ENDMENU 


1.2.4 AUTOEXEC.BAT 


Once the boot volume has been mounted on a virtual drive by a 
statement in the user's profile, or by a keyboard command, or 
inserted in a real drive, the line BOOT A: or BOOT C: will be 
read and executed by the BOOT program. The operating sys- 
tem on the boot volume is then loaded into the computer. For 
DOS any AUTOEXEC.BAT file commands will then be exe- 
cuted. 


The distributed AUTOEXEC.BAT on /LIB/IBMPC/DOS is used 
when the standard menu is used. It assumes that the user has 
booted from drive C: because C: is the only drive that the library 
can be booted from. AUTOEXEC.BAT then sets the DOS path 
to drive C:, allowing access to all the Nestar-distributed software 
even if another drive is the default drive. 


If the user needs to run an application program, the application 
disk with the software and its AUTOEXEC.BAT must be 
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installed and mounted on drive F: during the boot process. A 
data volume can also be mounted RW on drive E:. 
AUTOEXEC.BAT (using the command NEST ?F) determines 
whether there is anything mounted on drive F:. If there is an 
autoexec on it, the default drive is set to drive F:, and 
F:AUTOEXEC.BAT is executed. This procedure allows applica- 
tion programs to be run automatically at startup. For more infor- 
mation on this and for details on how to add application pro- 
grams to the menu, see Sections 6.5 and 6.6. 


If there is no application disk mounted on drive F:, but the user's 
work volume is mounted on drive E:, then E:AUTOEXEC.BAT is 
run. This allows the user to mount his work volume on drive E: 
and then use the standard Nestar boot menu to boot from PC 
DOS. 


By booting the standard library volume and mounting the work 
volumes on drive E:, you eliminate the need to make the work 
volume bootable, and you save the space consumed by the IBM 
DOS system files. 


If necessary the STARTUP utility (Section 5.1) can be run from 
AUTOEXEC.BAT. 
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Summary 


THE BOOT PROCESS 


WHICH PROFILE TO USE? 


At boot time the startup commands in the user's profile are exe- 
cuted. The profile’s startup menu is displayed if present. 


The profile to be used, if found, is 


(1) //SYSTEM/PROFILE/$nn (where $nn is the station address 
in hexadecimal), or 


(2) /SYSTEM/PROFILE/MENU, or 


(3) Prompt for a profile pathname 


THE BOOT MENU 


Once the profile has been found, any commands in the prolog 
(that is, commands up to the word MENU) will be executed. 
Note that a profile might contain only the prolog, always mount- 
ing and booting the same volumes. 


Next any Menu header text will be displayed on the screen, and 
the Menu prompts from the profile will be displayed. (Optional) 
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USING THE MENU 
Select a menu item. 


The commands in the profile that are associated with that item 
will be executed. 


if an error is returned by the File Server, the user will be 
prompted: 


Ignore? (Continue executing commands for the menu item) 


Retry? (Retry the command that returned an error after the 
condition causing the error has been fixed) 


Abort? (Return to the menu display) 


LEAVING THE MENU 


Use a BOOT menu item to boot a volume and execute the DOS 
commands in AUTOEXEC.BAT if present. 


Press <Esc> to return to the profile. The commands in the epi- 
log (which follows the line ENDMENU) will be executed. 
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1.3 Creating Profiles 


Enter the desired profile startup commands in a text file in any 
network-supported environment using a text editor. Convert this 
file to a Type=T (Text) volume using TCOPY (Section 5.2). 


Profile pathnames are of the form 
//SYSTEM/PROFILE/NAME 
where NAME is: 


the station address $NN (in hexadecimal) 
or 

MENU 
or 

any arbitrary name that you choose 


BOOT searches for a profile in this order. If pathnames ending 
in $NN or MENU are not found, the user will be prompted for 
NAME. 


Any string entered is interpreted as a pathname. Passwords in 
pathnames are not displayed as they are typed (passwords are 
discussed below). If the string does not begin with /, the default 
directory //SYSTEM/PROFILE will be prefixed to it. 


(Pathnames and volume types are discussed in the PLAN 
Series Network Command Reference Manual and Appendix A 
of this manual. The words "virtual volume”, “virtual diskette”, 
and "Network file" are used interchangeably in this manual.) 


lf a volume with the specified pathname is not found, or if a net- 
work error is returned regarding the volume, BOOT will prompt 
for a different profile. If the volume is read-protected, BOOT will 
prompt for a password, which is used to set the PRVPW and 
then attempt again mounting the same volume. Otherwise the 
profile volume will be mounted, and its startup commands will be 
read and executed. 


To utilize fully the profile startup capability you will need to be 
familiar with file server and specia! BOOT-supported commands 
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and with the utilities discussed in Chapter 5. Local commands 
are discussed in Section 2.6. 


One useful way to edit the contents of an existing boot profile is 
to use a batch file in conjunction with TCOPY. For example, if 
the batch file is called TEDIT.BAT, invoke it by typing 


TEDIT <pathname> 


where <pathname> is the pathname of the boot profile to be 
edited (;//SYSTEM/PROFILE/$90, for example). TEDIT.BAT 
should contain the lines 


echo off 

L:tcopy n,%1 ,tedit.tmp,replace 
L:editor tedit.tmp 

L:tcopy d,tedit.tmp,%1,replace 


This batch file copies the profile <pathname> to a temporary 
file on the default DOS volume, invokes an editor (such as 
EDLIN)--called in this example “editor"--which is on the library 
volume mounted on drive L:. Once you are done editing, 
TEDIT.BAT copies the file back to the original pathname. 


The batch file in this example assumes that the TCOPY utility is 
in the library volume mounted on drive L: and that you have an 
editor that accepts a file name on the command line. 


WARNING: //SYSTEM/PROFILE/MENU is the default profile. 
It should not be changed by anyone but you as the system 
manager. 


Profiles may also be customized for use with application pro- 
grams. See Section 6.4. 
1.4 Profile Commands 
The BOOT program understands some but not all of the com- 
mands you use on the network when they are entered as lines 


in a profile volume. File Server commands are allowed; “local” 
(Section 2.6), secondary file server (Section 2.8), and operating 
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system commands are not allowed. Comments can be placed 
between commands by starting each comment with a semi- 
colon. 


In addition BOOT understands the commands 


BOOT (1.4.1) 
PROFILE (1.4.2) 
BASIC (1.4.3) 
PAUSE (1.4.4) 
PRINT (1.4.5) 
CLEAR (1.4.6) 
ECHO/NOECHO (1.4.7) 
MENU (1.4.8) 
ENDMENU (1.4.8) 
NET (1.4.9) 
<Esc>Bbf (1.4.10) 
NOCOLOR (1.4.10) 


Network commands are sent to the default file server. Typing 
@$NN <command> or @NNN <command> 


will cause <command> to be sent to the file server with hexa- 
decimal address $NN or decimal address NNN. 


Typing 
@$NN or @NNN 
will change the default file server to $NN or NNN ($NN is the file 


server's hexadecimal address; NNN is the file server's decimal 
address and can be any number, 1 through 254). 


Typing 
@<Return> 


will display the address $NN of the current default file server. 
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1.4.1 The BOOT Command 
The command 
BOOT A: or BOOT C: 


causes the BOOT program to boot the real or virtual diskette 
currently on drive A: or drive C:. Specify drive A: if the user is to 
boot a real floppy diskette. Specify drive C: if the user is to boot 
a real hard disk. 


If a virtual disk is to be booted, the volume must have been pre- 
viously mounted on drive A: or C:. Only those volumes that are 
floppy-size (320, 360, 640, or 720 blocks) can be booted from 
drive A:. However, volumes of any size can be booted from 
drive C:. 


Virtual volumes can be booted regardless of what (if any) real 
devices your system has, and those real devices remain acces- 
sible after booting (see Section 1.9). 


When the boot command is executed, the operating system on 
that volume is loaded into the user's workstation, and the com- 


mands in the volume’s AUTOEXEC.BAT file (if any) are exe- 
cuted. 


1.4.2 The PROFILE Command 
Including the line 
PROFILE pathname 
in a profile volume causes the BOOT program to exit the current 


profile and execute the commands found in the profile named 
"pathname". 


Typing in 


PROFILE pathname 
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from the keyboard causes the commands in the profile named 
“pathname” to be executed. 


If no / appears at the beginning of “pathname”, the default prefix 
/ISYSTEM/PROFILE will be added. 


Typing in (or including as a line in a profile) the line 
PROFILE 


with no pathname specified, causes BOOT to prompt on the 
screen for a profile pathname. 


For example, the profile 
SYSTEM: PROFILE; $nn 

might contain only one line: 
PROFILE 


In this case, each time that station $nn is powered on the user 
will be prompted for the name of a profile. 


The profile specified can be the current profile if the PROFILE 
command is located in the MENU or epilog (post-ENDMENU) 
portion of the profile (see Section 1.4.3). This allows restarting 
of the profile from the menu. 


Passwords 


If a profile is read-protected, BOOT will prompt for a password. 
The password the user supplies is then used to set the PRVPW 
for the station before another attempt is made to mount the pro- 
file volume. Passwords prevent unauthorized access to a pro- 
file. 


STARTING UP 
When accessing a password-protected profile, the user will be 
prompted until he enters the correct password. 
However if the user attempts to access a password-protected 
profile from the menu, he will be prompted only once for the 
password. Failure to provide the correct password will result in 
his being returned to the previous menu. 
1.4.3 The BASIC Command 
Including the line 

BASIC 

in a profile, or typing BASIC in from the keyboard, will cause 
BOOT to branch to the resident BASIC in ROM, if it is present. 
In this case the user will not be connected to the network. To 
connect to the network he must reboot the system. Rebooting 
will only work if the station has BASIC in ROM, if it doesot, the 
error message "ROM BASIC not available” will be displayed. 
1.4.4 The PAUSE Command 
Entering the line 


PAUSE <text> 


in a profile causes BOOT to print the message <text> on the 
screen and to suspend activity until the user presses a key. 


If no text is specified, the message 
"Press any key to continue...” 


is displayed during the wait state. 
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1.4.5 The PRINT Command 
The command 

PRINT <text> 
causes <text> to be displayed on the screen when the PRINT 
command is encountered in the profile. <text> is followed by a 
carriage return and line feed, and only one line can be printed 
on the screen for each PRINT command. 
For example, 

PRINT This is Fred’s profile 
causes 


This is Fred’s profile 


to be displayed at startup. 


1.4.6 The CLEAR Command 
When the command 

CLEAR 
is encountered, BOOT will clear the screen. Normally you will 
want the screen cleared when a menu is displayed or when 
BOOT prompts for a profile. 
1.4.7 The ECHO/NOECHO Commands 
Preceding a command with ECHO causes the command to be 
displayed on the screen before the command is executed. 
Entering ECHO on a line by itself causes all subsequent com- 


mands to be displayed on the screen as they are encountered. 


Precede a command with NOECHO and the command will not 
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be displayed--even if a global ECHO has been set. Including 
NOECHO on a line by itself will turn off the screen display of 
subsequent commands. 


1.4.8 The MENU/ENDMENU Commands 
Any lines in a profile between the lines 
MENU 
and 
ENDMENU 


that begin with the symbol ">" are displayed as menu items on 
the screen at startup. Up to ten user-defined menu items can be 
entered. 


In addition, any lines following the MENU command, up to the 
first ">" prompt line, will be displayed as the menu's header. 
(However, if all ten menu items are defined, only the last line of 
the menu header will be displayed.) 


BOOT will preface each menu item by a keyboard function-key 
symbol. Pressing that function key will cause the commands 
associated with that menu item to be executed. In addition, 
BOOT will add an “Escape” item to the end of the menu. The 
"Escape" item allows the user to return to the current profile at 
the profile line following ENDMENU. 


Any lines that follow a menu item in a profile are executed as 
commands if that menu item is selected at startup. 
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For example including the lines 


MENU 
Welcome to Fred's workstation! 


>Boot into DOS work disk one 
MOUNT //USERS/FRED/DOSDISK1,C:,RW 
BOOT C: 
>Boot into DOS work disk two 
MOUNT //USERS/FRED/DOSDISK2,C:,RW 
BOOT C: 
>List any volumes on file server $FE 
(@$FE LIST /USERS/FRED, NESTED, VERBOSE 
PAUSE Press any key to return to Menu 
>Chain To Mary's Profile 
PROFILE MARY 
Enter new profile 
PROFILE 
ENDMENU Enter commands from the keyboard 


in a profile will cause the following menu to be displayed at 
startup: 





Welcome to Fred’s workstation! 
F1 Boot into DOS work disk one 
F2 Boot into DOS work disk two 
F3 List any volumes on file server $FE 
F4 Chain To Mary’s Profile 
F5 Enter new profile 
Esc Enter commands from the keyboard 


Please select 
ns T et Be 53 | 
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There is no limit to the number of header lines that can be 
included although some may not appear on the screen if there is 
not enough room. 


Leading spaces in header lines (used, for example, to center the 
lines on the screen) are permitted. 


Pressing the <F1> function key will cause BOOT to mount 
Fred's DOS work disk’1 volume on drive C: and boot it. No 
further menu items can then be selected. 


Pressing the <F2> key will cause Fred’s work disk/2 volume to 
be booted on C:. No further menu items can be selected. 


Pressing <F3> will cause BOOT to list all of Fred’s volumes on 
the file server $FE, ending with the prompt "Press any key to 
return to Menu". Boot will then wait for a key to be pressed 
before redisplaying the menu. The user can then make another 
menu selection. 


Pressing <F4> will cause BOOT to search for a profile with the 
pathname 


AHSYSTEM/PROFILE/MARY 


and execute the commands found in it. If MARY’s profile cannot 
be found, BOOT will return to the menu. 


Pressing <F5> causes BOOT to prompt for a profile pathname. 
Any commands in that profile will then be executed. 


Pressing <Esc> will cause BOOT to return to the profile and to 
execute any command lines that follow ENOMENU (such as 
PAUSE or BASIC). 


If no commands follow ENDMENU in the profile (as in the 
example above) pressing <’Esc ~ causes BOOT to go to “key- 
board" mode (Section 1.7). In this case include text in the END- 
MENU line, such as 


ENDMENU Enter commands from the keyboard 
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and the menu will display 
Esc Enter commands from the keyboard 


ENDMENU without text will display the default prompt. 


AUTOMATIC SELECTION 
You can preselect a menu item causing it to execute automati- 
cally after a time delay. To do so, specify the DELAY parame- 
ter on the MENU command line: 

MENU DELAY n 
where n represents the number of seconds to wait until the 
menu item is automatically executed. Next tag the menu item to 


be executed with the symbol "> >" instead of the normal ">". 


To escape automatically from the menu and enter commands 
from the keyboard, place a ">" after ENDMENU: 


ENDMENU> 
During the delay a blinking function-key symbol will indicate the 
tagged item. You can disable the automatic mode by pressing 
the space bar (the blinking will stop). 
Pressing the space bar again will reactivate the countdown. 
Select an alternate item at any time by pressing the appropriate 
function key. 
ERRORS 
lf BOOT encounters an error while executing a network com- 
mand associated with a menu item, the command and error will 
be displayed, followed by the line 

Abort, Retry, Ignore? 


which is described above in Section 1.2.2. 
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1.4.9 The NET Command 
The command 
NET 


causes BOOT to prompt for commands from the keyboard. 
Legal commands include file server commands and BOOT pro- 
gram commands. 


If the "NET" sub-mode is invoked from a menu item, entering 
QUIT or "Q" will cause BOOT to return to the menu item and 
execute any remaining commands. Otherwise, entering QUIT 
will cause BOOT to prompt for a profile. 


1.4.10 Color/Highlighting Control and the NOCOLOR 
Command 


Normally the BOOT program displays text as white characters 
on a black background for a monochrome monitor or as white 
characters on a blue background, with blue border, for a color 
monitor. These defaults can be changed for each menu display 
by including in the MENU command an escape sequence 


MENU <Esc>Bbf 


where <Esc> (the escape character) is followed by three attri- 
bute codes: B (border), b (background), and f (forground) in 
hexadecimal. See the table below for color options and their 
corresponding hexadecimal code: 


COLOR HEXADECIMAL CODE 


Black 
Blue 
Green 
Cyan 
Red 
Magenta 


mh OM ~~ © 
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Brown 

White 

Gray 

Light Blue 
Light Green 
Light Cyan 
Light Red 
Light Magenta 
Yellow 

White 


TNMOONODPYPOAOND 


For example, the command MENU <Esc> 874 changes the 
color display to red characters on a white background with a 
gray border. Note that if you select gray, light blue, light green, 
light cyan, light red, light magenta, yellow, or white as your 
background color, the background will blink. 


For further information, see the PC, AT, or XT version of the 
IBM Technical Reference. 


Escape codes in the form <Esc>bf can also be embedded 
within strings to change the display attributes of the characters 
that follow. For example, the print command 


PRINT This is <Esc> Fred's <Esc>07 profile 


will display the string "This is Fred's profile’ with the word 
“Fred's” highlighted. 


A menu prompt can also be displayed in a different color. For 
example, 


> <Esc>1e Boot into DOS work disk one 


will show the prompt as yellow characters on a blue back- 
ground. 


The command 


NOCOLOR 
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suppresses color display. Use it for machines equipped with a 
color board and a black and white monitor. 
1.5 Multiple File Servers 
If multiple file servers are present, BOOT will be loaded into the 
user's workstation by the first file server that realizes the station 
has been rebooted. The BOOT program will search that file 
server for the volume: 

i/SYSTEM/PROFILE;$nn 
If the user's boot volume resides on another file server's hard 
disk, you can include that file server's address in the MOUNT 
command: 

(@$NN MOUNT */USERS/FRED/1,C:,RW 
mounts //USERS/FRED/1 on drive C: on file server $NN. 
When the line "BOOT C:” is reached at the end of the profile, 
the volume on file server $NN, drive C: will be booted regard- 
less of the file server that first answers. 
Alternately you can include the single line 


PROFILE @$NN 


in all the profile volumes on all file servers except FS $NN. 
BOOT will then search for /SYSTEM/PROFILE/$nn on $NN. 


You can also include the line 
PROFILE «@$NN <pathname:- 


in all file server $nn profiles, causing BOOT to chain to the pro- 
file named “pathname” on the desired file server SNN. 


Secondary file server commands, described in Section 2.8, are 
not supported by BOOT. 
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1.6 Errors During Booting 


If BOOT attempts to execute a command found in a profile but 
receives an error message from the file server, the command 
and error will be displayed, followed by 


Abort, Retry, Ignore? 


Pressing "A" for Abort will cause BOOT to abandon the profile 
and prompt for commands from the keyboard. 


Pressing "R" for Retry will cause BOOT to reissue the com- 
mand. 


Pressing "I" for Ignore will cause BOOT to skip the command 
and go on to the next command in the profile or in the 
Current menu item. 


The following messages are errors reported by the commands 
ECHO BOOT A: and ECHO BOOT C:. If "ECHO" is not 
included in the command (BOOT A: or BOOT C:), the error is 
not reported, and BOOT will continue with the next line in the 
profile. 


Read Failed - A network error occurred while attempting to boot. 
Check your file server and retry booting. If the station 
continues to fail to boot, use CARDCHK to test the Net- 
work Interface Card. 


Disk Not Bootable - Dos is not on the volume you are trying to 
boot. 


OEM Not Supported - You are trying to boot a DOS from some 
manufacturer other than IBM. 


Drive invalid - You are attempting to bbot from some drive other 
than A: or C:. These are the only two ddrives that a 
volume can be booted on. 


Disk Not Floppy Size - You are attempting to boot a volume on 
drive A: that is not floppy size. You can boot non-floppy 
size volumes on C: only. 
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Bad Volume Type You are trying to boot a volume that is not a 
type T=! volume. 

Two Hard Drives - you are trying to boot from C: on a system 
with two hard drives. You can only boot from A: on a 
system with two hard drives. 

1.7 Keyboard Commands 

If no profile is to be used, enter “:’ to the prompt 

"BOOT profile ?", 
and the prompt 


Please enter commands (type ? for help) 


will be displayed 


This prompt for keyboard commands will also appear if no 
BOOT command is found in a specified profile. 


Enter any desired startup commmands (including network com- 
mands) at the keyboard (Section 1.4). 


Finish with the line 
BOOT A: or BOOT C: 
For example, in response to "Please enter commands,” typing 


MOUNT -‘USERS,FRED:1,C:,RW 
BOOT C: - 


will mount 
AUSERS, FRED, 1 


on drive C: for read;write update usage and boot it. 
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1.8 Booting from a Local Floppy or Hard Disk 


When a BOOT command specifies a drive on which there is a 
virtual volume mounted, BOOT will boot from the virtual volume 
even if a real disk is present. This real disk will then be 
remapped to a higher drive letter (see Section 1.9). Otherwise 
BOOT will boot from the local disk. 


Use BOOT A: or BOOT C: only. 


1.9 Accessing Real Devices if Booted from a Virtual 
Volume 


On a standalone IBM PC or IBM PC AT, the floppy and hard 
disk drives are assigned letters consecutively when DOS starts 
up. Since either drive A: (the normal floppy drive) or drive C: 
(the normal hard disk drive) can become virtual when a volume 
is booted on it, the real devices will no longer be accessed as 
drive A: or C:. The table that follows describes the drive letter 
assignments for various configurations of the system 


The basic rule is that if you boot from a virtual device mounted 
on a drive letter that normally has a real device, the real devices 
are "displaced" upward to higher drive letters. (F-- Floppy: 
HD=Hard Disk; L=Left; R =Right) 


Additional floppies will be assigned the next letter(s) after the 


right drive. A second hard disk will be assigned the letter after 
the first hard disk. 
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Devices Real Real Virtual 
Booted Floppy Hard Drives 

F HD From __ LR Disk 

0 o0 Virt A A.Z 

0 0 Virt C A.Z 

1 0 Real A A&B C.Z 

1 0 Virt A B A,C.Z 

1 0 Vit C A&B C.Z 

1 1 Real A A&B C D.Z 

1 1 Real C A&B C D.Z 

1 1 Virt A B C A,D..Z 

1 1 Virt C A&B D C-E.2Z 

2 0 Real A AB CacZz 

2 0 Virt A BC A,D..Z 

2 0 Virt C AB C. Z 

2 1 Real A A B C D.Z 

2 1 Real C AB C D.Z 

2 1 Virt A BC D A,E.Z 

2 1 Vit C A B D CEZ 


1.10 Contents of Boot Volumes 
To provide IBM Personal Computers with support for virtual 


disks on the network the real or virtual boot volume (diskette) 
must contain: 


— NETWORK.SYS file (containing virtual device drivers) 


— NET.EXE file or STARTUP.EXE (optional; used to supple- 
ment the commands entered in profile volumes) 


— CONFIG.SYS (which must contain the line 
DEVICE =NETWORK.SYS) 
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— BOOT sector in format set up automatically by the NET pro- 
gram INIT command using the SYS option 


— System files IBMBIO.COM, IBMDOS.COM, and 
COMMAND.COM (also set up automatically by the SYS 
option of the INIT command in NET.EXE) 


Using this boot volume, follow the "How to Start DOS” instruc- 
tions in Chapter 1 of the /BM DOS Manuals (for DOS version 
2.00), or the IBM DOS References (for DOS versions 2.10, 
3.00, or 3.10), and in Section 1.1 of this chapter. 


For a list of DOS files distributed on the shared library volume 
‘MAIN/LIB/IBMPC/DOS, see Appendix C. 


WARNING: The DOS command ASSIGN should NOT be 
used with the network. The ASSIGN command works only in 
systems employing eight drives or less. If your system 
employs more than eight drives, using the ASSIGN com- 
mand can destroy data on your volumes. 


The BUFFERS= parameter in CONFIG.SYS as distributed is 
set to 5. This value allows booting 256K memory machines and 
running all Nestar application software except for the 
DATASTORE:LAN, which requires a minimum of 320K 
memory.) 


If all machines on the network are 160K or larger, you may want 
to increase the BUFFERS= parameter to the IBM recom- 
mended value of 10 or 20 (for more information, see pages 4-7 
to 4-10 of the /BM DOS Version 3.10 Reference). 
If you wish to use VDISK.SYS, the line 

DEVICE=VDISK.SYS 


must be added before the line 


DEVICE =NETWORK.SYS 
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A number of error messages may be displayed during startup: 


(1) "NETWORK.SYS bad or not found" 


(2) 


(5) 


This message indicates that the virtual device driver is not 
on the boot disk or has been corrupted. Copy the file 
NETWORK.SYS from the distributed library 


/MAIN/LIB/IBMPC/DOS 


"Too many block devices” 


This message indicates that DOS 3.00 is being booted with 
NETWORK. SYS configured to have more than 26 drives. 


"Bad or missing Network Interface Card" 


This message indicates that NETWORK.SYS has not found 
or has failed to initialize any Network Interface Cards. 


"Incorrect version of ROM in Network Interface Card" 


This message indicates that NETWORK.SYS has detected 
an incompatible ROM. 


“Bad or missing COMMAND.COM" 


A copy of COMMAND.COM is required on your boot 
volume. This message indicates DOS could not find it. 
Copy a COMMAND.COM from another bootable volume 
and reboot. 
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1.11 Creating Network-Bootable Diskettes 


1.11.1 Real Diskettes 


NOTE: IBM licenses DOS for use on one IBM PC. According to 
the terms of the license for DOS, you must obtain one copy of 
DOS for each machine on the network that is to run DOS or 
application programs that run under DOS. 


To prepare a blank diskette (or one whose contents are no 
longer required) for use as a Network Boot Diskette: 


(1) Set your default drive to be a bootable Nestar diskette and 
FORMAT the blank diskette using the ‘S option. The easi- 
est way to do this is to get an existing network boot disk 
and boot using that. The original network boot disk will be in 
drive A:, and A: will be the default drive once the booting 
process is completed. 


(2) Use the DOS COPY command to copy NETWORK.SYS, 
CONFIG.SYS, NET.EXE and/or STARTUP.EXE, and any 
other files wanted to the new diskette. 


(3) Be sure there is a CONFIG.SYS file. It must contain the line 


DEVICE = NETWORK.SYS 


(4) If necessary, edit the AUTOEXEC.BAT file (see Batch 
Commands in your DOS manual) to call STARTUP.EXE. 


If necessary, edit the file STARTCMD (see Section 5.1) to 
set the date and mount personal and library volumes. 


NOTE: An automatic procedure to accomplish the steps above 
has been provided as MAKEBOOT.BAT on the distributed 
library volume //LIB/IBMPC.DOS. 
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1.11.2 Virtual Disks 


The library volume ;/LIB/IBMPC,DOS is a bootable volume as 
shipped with your system. Being much larger than a floppy disk, 
this volume is slower to boot than a smaller disk because its 
FAT and directory are larger, both of which must be brought into 
the memory of your IBM PC during boot. Also the volume must 
be mounted on drive C:, which may or may not be the most 
convenient way to boot. Therefore, you may want to make a 
bootable virtual volume smaller than the library volume. 


To create a virtual bootable volume, first boot the library volume 
/LIB/IBMPC’DOS. Then run the NET program. Use the com- 
mand INIT to create and initialize your virtual volume. 


To boot on drive A: the SIZE that you specify in the INIT com- 
mand should be left blank, thus creating a 720 sector volume, or 
the SIZE should be specified as 320, 360, 640 or 720 sectors. 
Any of these volume sizes is appropriate for a "small" floppy- 
sized volume. 


To boot only from drive C:, specify any size or leave blank. 


In addition, specify the SYS option on the INIT command. The 
SYS option will make the virtual volume bootable. At the suc- 
cessful conclusion of the INIT command, the new volume will be 
bootable. 


Additional! files that can be put onto the volume to govern the 
booting process are documented in Chapter 4 of the IBM DOS 
Version 3.10 Reference. 


In order to use virtual volumes other than the one you boot 
from, you need to use the CONFIG.SYS and NETWORK.SYS 
files. In order to automatically execute a program when the 
booting process is completed, you need the AUTOEXEC.BAT 
file. These files can be copied from the library volume after the 
INIT command is completed. 


1-33 


STARTING UP 


1.11.2.1 Logging On For the First Time using the Nestar 
"Newuser” Main Option 


At power-on or after rebooting your machine the Nestar Main 
Menu will appear unless you have modified your network pro- 
files. To log on to the network for the first time (or to enroll any 
new user) and to create a personal work space on the network 
disk that will be available to the user at startup on drive E:, 
select the “System Manager" option from the Nestar Main 
Menu. The Main Menu, as shipped, prompts you to provide a 
password ("Nestar"). Next the System Manager menu will 
appear. From this menu select the "NEWUSER" option. 


The NEWUSER program creates a workstation profile that 
chains to a user profile, a user profile that boots the library 
volume on drive C:, and an IBM PC DOS personai volume 
mounted on drive E: that contains an AUTOEXEC.BAT file (for 
details on AUTOEXEC.BAT files, see Section 1.2.4), and virtual 
printer parameters (for details on virtual printer parameters, see 
Chapter 3). 


Do not mount any volumes while running NEWUSER, or the 
program may terminate abnormally. NEWUSER searches 
from drive Z: to drive A: for an available virtual drive to 
create T=T and T=! volumes. This drive is unmounted 
before the utility completes its program. 


NEWUSER will prompt you as follows: 


(1) Enter the Drive Where Template Files Are Kept: 


Enter a letter, "A" - "Z", to designate the drive where the 
NEWUSER “templates” are mounted. The drive letter can 
be entered in upper or lower case. Do not use a colon. 


The NEWUSER templates are shipped in the DOS library 
volume. They are text-file examples of the profiles, the 
AUTOEXEC.BAT file, and virtua! printing parameters to be 
used by this utility. Their form and contents are described 
in Appendix G of the PLAN Series File Server Installation 
and Operation Manual. 
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Enter User's Home FS Station Number: 


Enter the station address of your default file server in 
decimal or hexadecimal. If the address is entered in hexa- 
decimal, it must be preceded by a dollar sign ($); alpha 
characters can be either upper or lower case. The address 
must be a value between 1 and 254. 


Enter Password for //USERS: 


In the program as shipped, the password is "Nestar" If no 
private password exists, simply press the <<Return: key 


Enter User's Workstation Number: 


Enter the station address of the workstation. The station 
address can be entered in decimal between 1 and 254 or in 
hexadecimal between $01 and $FE (preceded by a dollar 
Sign), provided that it is not the station address of an active 
file server or that a profile does not already exist for that 
particular station. 


Enter User's ID: 


Enter an ID that consists of 1 to 15 printable ASCII charac- 
ters, provided that the paths ‘USERS and 
//SYSTEM/PROFILE on the specified home file server do 
not already contain this name. Blank spaces, slashes (,), 
and colons (:) are not accepted. 


Enter User's Private Password (opt.): 


Define and enter a password that will grant full private 
access (RWECD) to the user profile volume 
„SYSTEM PROFILE USERID and the personal work 
volume .,.USER;USERID/PCDOS. The password should 
consist of 1 to 15 printable ASCII characters. Blank spaces, 
slashes (:), or colons (:) are not accepted. Should a pass- 
word be defined, the user's profile and the personal work 
volume will not have public or group access. 
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If you do not want to define a password, simply press the 
<Return> key. 


(7) Enter User's Volume Size in Blocks: 


Define and enter the desired size of the personal work 
volume (in 512-byte blocks). The value must be entered in 
decimal. The valid range is from 360 to 65535. 


lf an error message appears after responding to any of the 
above prompts, you will be re-prompted until an appropriate 
response is entered. To escape from the re-issued prompts, 
press the <Esc> key. 


Suppose you entered the following: 


TEMPLATE DRIVE: Z: 
HOME FILE SERVER: $F8 
PASSWORD FOR //USERS: ABCD 
WORKSTATION: ` $3C 
ID: BOB 
PASSWORD: XYZ 
USER'S VOLUME SIZE: 360 


The information above, excluding the “Default Drive”, will then 
be displayed, along with the following prompt: 


ADD THIS USER? 
Respond with Y(es or N(o (upper or lower case accepted). 


Should you decide not to add the user to the network, you will 
be prompted: 


ADD ANOTHER USER? 
Again respond with Y(es or N(o (upper or lower case accepted). 


If you say Y(es, you will be prompted for the "User's Home File 
Server Station.” A N(o response will terminate the program. 
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For example, deciding to add BOB to the network will result in 
the creation of the workstation profile  SYSTEM/PROFILE/$3C, 
the user profile /SYSTEM/PROFILE/BOB, and the IBM PC 
DOS personal work volume //USERS/BOB/PCDOS (size of 
volume is 360 blocks), all on the designated home file server. 
The personal work volume will also contain an AUTOEXEC.BAT 
file and a file containing virtual printer parameters. If a user 
password was defined, the user profile and the work volume will 
have full private access rights (RWECD), but no public or group 
access rights. If a password was not specified, the user profile 
and work volume will be given default protection with no pass- 
words. 


Note that the workstation profile that chains to the user profile 
will be created only on the home file server. If multiple file 
servers exist on your network, workstation profiles must be 
created on all non-home file servers on the network as well. 
Once created, these workstation profiles on the non-home file 
servers will chain to the workstation profile on the home file 
server, which, in turn, will chain to the user profile. To create the 
workstation profile on the non-home file servers, create a file at 
your workstation containing the line 


PROFILE «č $FS 
where FS represents the station address of your home file 


server. TCOPY this file to each non-home file server on the 
network. (For more on TCOPY, see Chapter 5.) 
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Below are sample volumes and files created using the informa- 
tion entered above: 


(1) Workstation profile /‘SYSTEM/PROFILE/$3C: 


UNMOUNT ALL 

MENU DELAY 5 

>>ENTER BOB'S PROFILE 

(C$F8 

PROFILE BOB 

>CHAIN TO DIFFERENT PROFILE 
PROFILE 

ENDMENU 


(2) User profile on ./SYSTEM:PROFILE/BOB: 
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BOB'S PROFILE 
STATION $3C’ 
FILESERVER $F8 


>>DOS 3.0 WITH BOB'S VOLUMES ON DRIVE E: 
$FE MOUNT ./LIB,IBMPC/DOS,C: 

MOUNT ,/USERS/BOB/PCDOS,E:,RW,EXC 

BOOT C: 

ECHO BOOT C: 

>SHOW THE TIME AND DATE 

SHOW TIME 

PAUSE 

ENDMENU 


For details on profiles and menus, see Sections 1.2.3, 1.3, 
and 1.4. 
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(3) AUTOEXEC.BAT on //USERS/BOB/PCDOS: 


ECHO OFF 

PATH C: 

NEST SET DIR //USERS/BOB 
COPY VPRN.HDR LPT3 


See Section 1.2.4 for details on AUTOEXEC.BAT. 


(4) VPRN.HDR on /USERS/BOB/PCDOS 


<ESC>V.N<ESC>VREQTYPE:PRINT 
<ESC>VSPOOLED:DATA 
<ESC>VSTATION:$3C 
<ESC>VID:CMS 
<ESC>VNAME:BOB 
<ESC>VSERVER:ANY 
<ESC>VPRINTER:ANY 
<ESC>VSETUP:STANDARD 
<ESC>VPRIORITY:STANDARD 
<ESC>VTITLELINE:NO 
<ESC>V.S 


For details on virtual printer parameters, see Chapter 3. 


In addition to the startup process described above, the network 
has facilities that allow you to create additional work volumes 
(see Section 2.4), boot from different volumes (see Section 
1.11) and create menus to be displayed at startup (see Sections 
1.2.3, 1.3 and 1.4). 


1.12 The Network Drivers File NETWORK.SYS 


1.12.1 Installation 


IBM DOS 3.10 supports linkable device drivers. DOS 3.10 inter- 
faces to the network via a set of device drivers supplied in a file 
called NETWORK.SYS. To link a device driver file into DOS 
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place the following line in a file called CONFIG.SYS on your 
boot volume: 


"DEVICE =NETWORK.SYS” 


This line informs DOS during boot that a file called 
NETWORK.SYS contains code to be added to the operating 
system. The devices implemented by NETWORK.SYS are as 
follows: 


— NCMD, a character device for issuing commands to the file 
server and reading responses 


— LPT1 or PRN, a “virtual” printer for printing on a print server 
— a virtual disk driver supporting from one to twenty-six drives 


— CLOCK$, a network clock device for maintaining time and 
date on the system 


NETWORK.SYS and a sample version of CONFIG.SYS are 
supplied on the distributed IBM DOS 3.10 library. 


If you wich to use VDISK.SYS, you must insert the line 
DEVICE =VDISK.SYS 

before the line 
DEVICE =NETWORK.SYS 


When a boot diskette is booted, you will be able to execute 
NET.EXE and issue network commands to mount volumes on 
the virtual drives. To do this automatically, use AUTOEXEC.BAT 
(see page 7-27 of the /BM DOS Version 3.10 Reference) to call 
STARTUP.EXE, which will interpret a text file of file server com- 
mands (Section 5.1, this manual.). See also Chaper 3 of the 
IBM DOS 3.10 Technical Reference. 
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1.12.2 The Network Command Device NCMD 


The network command device is a character device that can be 
read or written like the console device CON. In normal usage a 
command line ending in a carriage return is written to the NCMD 
device and one or more response lines are read from NCMD. 
The last line is tagged by a plus sign ("+") in the first column. 
The intermediate lines start with a minus sign ("—") or a blank. 
All of the response lines from the file server MUST be read 
before another command is written. The network command 
channel supports all file server commands and a few special 
commands that are processed locally. 


The network command device supports the “terse” commands 
"?" and "@". The "@" command is used to change the file server 
that commands are sent to. This change can be for one com- 
mand or for all subsequent commands. The "?" command 
checks the state of a drive or the command channel. 
“Fo? Fa" asks for the address of the current default file 
server. 


?<drive letter> returns a description of the volume currently 
mounted on the specified drive. 


Examples (file server responses are preceded by a return 
value): 


Xa 

(What is the current file server?) 
79,FS=$FE 

(We are talking to file server $FE) 


MOUNT ;DEMOʻJUNK:2,E: 
(Mount a volume from $FE on drive E:) 
0,OK 


?E 

(Ask about the volume on drive E:) 

72,FS=$FE, T=I, RO, SHR, SIZE = 1000.B,PS =RW,PE =0,SS 
=RO,SE=0 

(The file server is $FE, and the volume is on drive E:. a Type =| 


1-41 


STARTING UP 


volume of 1000 blocks, is mounted for RO/SHR usage. The 
status of the drive for the current primary file server is for 
Read/Write use; the status of the current secondary file server 
is for Read Only use. Primary and secondary IOB error codes ` 
O (no error occurred in the last operation). 


(C$F9 
(Changes the default file server to $F9.) 
0,OK 


($FE timestamp 

(The command is sent to file server $FE, but the default 
remains $F9.) 

70,yymmddhhmmssw 


MOUNT .;USERS,SALES/1,D:,RW 

(Mounts the volume on file server $F9.) 

?D 

(Get status of drive D:) 

72,FS =$F9,T =|,RW,UPD,SIZE = 400.B,PS=RO,PE=0,SS=RW, 
SE=0 . 


(254 
(The "@" command also accepts decimal; 254 = $FE.) 


?C 

(What kind of volume is mounted on drive C:?) 
92,No drive information 

(No volume.) 


2A 

(How about drive A:7?) 
93,Drive not virtual 

(Drive A is a floppy drive.) 


1.12.3 The Virtual Disk Driver 
The virtuat disk driver allows the user to access from one to 


twenty-six drives on one or more file servers. These drives are 
assigned letters after the floppy and hard disk drivers have been 
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linked in. See Section 1.9 for more on real and virtual drives. A 
particular volume is mounted on a drive via the NET program 
and accessed by referring to that drive in the usual fashion: 


A>net 


Enter network commands 

: mount //LIB/IBMPC/DOS/L: 

: mount //USERS/SALES/WORK,D:,RW 
: quit 


A>L:edlin D:doc.txt 


1.12.4 The Virtual Printer Driver 


The virtual printer driver is a character device that allows the 
user to use a network printer (on the Print Server) as if it were 
locally attached. Text can be directed to the network printer by 
specifying LPT1 (or PRN) as the output device. The virtual 
printer can be used to print a list of data files using the PRINT 
command. You can also dump a screen display to the virtual 
printer through the Print Screen facilities. See Section 3.2 of this 
guide for more on virtual print facilities. 


1.12.5 The CLOCK$ Driver 


A network clock driver is installed as the current clock device 
CLOCKS. It is a character device that can be read from or writ- 
ten to. Reading from the device gets the date and time; writing 
to the device sets the date and time. The device automatically 
sets your system's date and time (obtained from the file server) 
if you boot from the network. If you do not boot from the net- 
work, the CLOCK$ driver will not initialize the system time, and 
you must explicitly do so by including DATE and TIME com- 
mands in your AUTOEXEC.BAT file or by using the SET DATE 
command via the STARTUP utility (see Section 5.1). 
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1.12.6 The NETCONFG Program 


The network driver as distributed for DOS 3.10 will operate with 
a set of standard parameters. A user can modify these parame- 
ters by running the program NETCONFG to configure the driver 
according to his/her needs. NETCONFG has a menu interface 
that lets you update the following parameters: 


Default file server station (default $FE) 

Clicking the speaker during network access (default ON) 
Device name of virtual printer (default LPT1) 

Whether <Alt> 222 can close the virtual printer (default yes) 
Timeout to close an idle virtual printer (default 15 seconds) 
Number of virtual disk drives (default 26) 

Number of additional request blocks (default 4) 

Number of times to retry disk errors (default 5) 


Initially the above default values are displayed along with the 
default driver file to configure (C:‘NETWORK.SYS). You can 
enter a different file name (with optional drive prefix), or you can 
simply press the return key, and the current values from the 
specified driver file will be displayed. Once the file is read, you 
should not unmount or remove the disk since final updates will 
be made to the same file. It is recommended that you first make 
a backup copy of the original network driver. 


Use the cursor keys to select the entry you want to change, and 
enter the new value. The default file server station address can 
be entered as a decimal or hex ($nn) number between 1 and 
254. Note that this default is meaningful only if you do not boot 
from the network. Otherwise the default file server you have 
booted from will remain the same after your system is booted. 


The virtual printer device (in the driver as shipped) is named 
LPT1, alias PRN (Section 3.2). NETCONFG can be used to 
change these names to VPRN, alias VPRN2, so that LPT1 (and 
PRN) will refer to a local printer (if present) (Section 3.4). 
NETCONFIG can also toggle VPRN (and VPRN2) back to LPT1 
(and PRN). 
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Ordinarily <Alt> 222 is used to close the virtual printer. If you 
need to use <Alt> 222 for some other purpose, you can turn 
off the <Alt> 222 closure. 


The virtual printer will automatically close itself after a certain 
time if it receives no characters. To disable this feature enter a 
timeout value of 0. The maximum timeout value is 3640 
seconds (60 minutes, 40 seconds). Note that if <Alt> 222 is 
turned off, there is no automatic closure of the virtual printer 
device. 


The number of virtual disk drives must be 26 or less. Note that 
DOS can only access up to 26 drives (A...Z). 


The number of additional request blocks controls how many 
simultaneous virtual circuits can be supported by the low-level 
network routines. Normally this need not be changed by the 
user. Applications that require a value other than the default will 
give you the new value in the installation instructions. 


Disk reads and writes are automatically retried if they fail. A 
value of O indicates that disk errors should not be retried. The 
default value is 5 retries. If you are using the Shadow File 
Server, the value should be set at 1. For more on the Shadow 
File Server, see Section 2.8. 


When done, type <Esc:> and "Y" to save the updates. You can 
abort the program by typing «Esc> twice followed by 
<Return>. 
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Chapter 2 


Using the Network 


2.0 Shared Disk Organization 


PLAN System users share mass storage by using "virtual 
volumes” (also called "virtual diskettes" or "network files") that 
are portions of shared network hard disks. These virtual 
volumes are formatted for use in various operating systems. 


Each virtual volume is given a pathname at creation. This path- 
name is used to identify the volume and the shared hard disk 
upon which it resides when network commands are issued by 
the user. 


2.1 Virtual Volumes of Variable Size 


As described in the PLAN Series Network Command Reference 
Manual, virtual volumes are “mounted' on ‘virtual drives” for 
use, and look like real DOS diskettes of (possibly) different 
sizes, with directories and files arranged according to DOS nam- 
ing conventions. You have the option of creating these volumes 
using the INIT command of the NET program (Section 2.4 of 
this manual and Chapter 5 of the PLAN Series Network Com- 
mand Reference Manual). 


DOS virtual volumes are network type "I" and range from 10 to 
65535 blocks in size (SKB to 32MB). Access and usage protec- 
tion for virtual volumes are described in Chapter 3 of the PLAN 
Series Network Command Reference Manual. 


2.2 Drives 


DOS 3.10 supports a maximum of 26 diskette drives. 
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Real drives are local. private diskette, or hard disk drives 
attached directly to the user station; virtual drives allow access 
to volumes that reside on a system disk connected to a (shared) 
file server station. 


If the user station has real floppy drives, they are each given a 
letter, starting with A: A,B,C,..... Note that even if it has only one 
floppy drive, DOS uses both A: and B: to refer to it. For two 
floppy drives, A: refers to one, B: the other. 


If the user station has a RAM disk or hard disks, they are given 
letters following the floppies in sequence. For example, when 2 
floppies and 2 hard disks are present, the floppies are A: and 
B:, the hard disks are C:and D:. 


Virtual volumes are lettered sequentially following floppy and 
hard disks. In the example above the first virtual volume would 
be E:. 


if the user has booted from the network, the virtual drive will 
appear as part of either the floppy disk (if booted from A:) or the 
hard disk (if booted from C:). If the user has booted from C, and 
if his station has one floppy drive and one hard disk drive, the 
floppy drive will be referred to as A:. The virtual boot disk will 
be C: and the hard disk will be D:. The other network volumes 
will start at E:. A second floppy would be B:. (See Section 1.9 
for more on the relationship of real and virtual devices to drive 
letter.) 


“Resource maps” are included at the end of this manual. Fill 
them in and use them when necessary to reference mounted 
volumes and other network resources. 


WARNING: The DOS command ASSIGN should NOT be 
used with the network. The ASSIGN command works only in 
systems employing eight drives or less. If your system 
employs more than eight drives, using the ASSIGN com- 
mand can destroy data on your volumes. 
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2.3 Network File Server Commands: the NET Program 


Virtual disks are created, mounted, renamed, deleted, and oth- 
erwise manipulated using the network NET program. 


The NET program is an interactive DOS command program 
supplied by Nestar. NET allows a user to enter network com- 
mands at the keyboard or from a program. 


Network commands handled by the NET program are normally 
local commands, which display or change system information 
within the workstation, especially drive stations, real or virtual, 
associated with each DOS drive, or they are file server com- 
mands, which are passed to the file server for execution. (See 
the PLAN Series Network Command Reference Manual, 
Chapter 5, for a listing of all available commands.) There is also 
a special INIT (initialize) command within the NET program, 
which is used to create new virtual volumes. INIT is described 
in Section 2.4. 


NET is generally made available as an executable file in the 
default library volume, which is usually mounted at startup on 
drive L: unless you have installed it elsewhere. 


There are four ways to type in information for use by the NET 
program: (1) from DOS, entering "NET", followed by commands 
on the same line; (2) running NET and issuing commands at the 
network prompt (:); (3) using the NWCMDs utility (if it is 
installed) by typing <Ctri=>> F and entering the commands in the 
network window which appears; or (4) or using DOS's I/O 
redirection feature to feed commands from a file to the NET pro- 
gram. 


lf a file server command produces an error message or other 
information, the message is passed back to the workstation for 
display. A complete list of error messages is found in Appendix 
A of the PLAN Series Network Command Reference Manual. 


NET then redisplays on the user station screen its prompt (:) for 
another file server command to be entered. The cycle repeats 
until Q <Return:> is entered; then control returns to the DOS 
command level. 
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Entering commands on the same line as NET is useful in batch 
(.BAT) files that you use to set up an environment for a particu- 
lar application. 


For example, a batch file used to back up a particular volume 
would contain: 


L:NET SET DIR /MAIN/USERS/ME 

L:NET MOUNT WORK1,F:; MOUNT BACK1,G:,RW 
ERASE G:”".* 

COPY F:*.* G:*.* 

L:NET UNMOUNT G: 


Here the batch file sets the prefix directory to 
/MAIN/USERS/ME. This prefix is automatically added to any 
pathnames subsequently entered. 

Next the batch file mounts the work volume 


/MAIN/USERS/ME/WORK1 


on drive F: for the default Read/Only usage, and the backup 
volume 


/MAIN. USERS;ME/BACK1 
on drive G: for Read/Write usage. 
The backup volume is then cleared of any previous data, and 
the data on the work volume is copied to it. Finally, the backup 


volume is unmounted. 


This example assumes that the library containing NET is 
mounted on L:. 


The second line uses the concatenation facility of the NET pro- 
gram. You can also enter commands in this way to set up an 
environment for a program and then run the program, as in the 
following batch file: 


L:NET MOUNT MAIN, USERS. ME; FINAN, WORK1,N:,RW 
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L:NET MOUNT ;MAIN/SALES: FORECAST,M: 
L:MODELPROG 


This batch file allows you to use a modelling program on the 
sales forecast figures without updating them (by mounting 
/MAIN/SALES:FORECAST for Read/Only usage, which is the 
default) and to create variant models on the WORK1 volume on 
drive N:. 


The separate calls to NET in the above examples are time con- 
suming, however, since NET is reloaded each time it is called. 
The network utility NEST (see Section 5.4) is much smaller and 
loads much more quickly. NEST can be used to better advan- 
tage here. 


To call NET only once, run the program by entering NET or put 
all NET commands in a text file and use the statement 


L:NET %filename 


to have them executed. The % refers NET to the file name that 
follows, and NET will execute the commands that it finds there. 


The remaining examples in this and the following sections 
assume that the NET program is running and that NET will 
prompt the user or application program for commands. 


The following printout shows a sample session. User responses 
are shown in lower case to distinguish them from information 
displayed by DOS and NET. (Actually the commands can be 
entered in either upper or lower case.) 


L>net 

> mount lunch, f: rw 

109,ROOT DIR NOT SPECIFIED; NO DEFAULT 

: set dir ‘mainsusers 

[No message in response to a command indicates that the 
command was successfully executed, and that the command 
calls for no response.| 


NETWORK 


: show dir 
iMAIN/USERS 
:mount lunch, f:, rw 
-q 

L> 


In this example a user runs the NET program, located in a 
library volume mounted on drive L:. The user wishes to mount a 
virtual volume on drive F: for use across the network. 


The user does not enter the volume’s full pathname, perhaps 
assuming that a part of the pathname will be added by a default 
set at startup by a "SET DIR” command. 


No such default “partial” pathname has been set, however, and 
an error message is returned. The user then sets a default par- 
tial pathname, /MAIN/USERS, for future convenience and asks 
that it be displayed ("SHOW DIR"). The user then mounts the 
desired volume and quits the NET program. (NET commands 
are discussed in detail in the PLAN Series Network Command 
Reference Manual.) 


Do not issue NET commands when <Ctril-><PrtSc> is 
enabled. 


To keep a record of the output from the NET program, execute 
the following: 


NET >C:filename 


"C" represents a real device (either a hard disk or a RAM disk). 
"Filename" represents the file that is to contain the saved out- 
put. 


Next type the desired network commands, ending with "Q" or 
QUIT. All output (including the NET banner and the prompt ":”) 
is sent to the file. The file must be on a real volume, not a vir- 
tual one. 


NETWORK 


2.3.1 Other NET Entries 


The NET program also accepts the following entries: 


;<anystring> 


Ignored as a comment. 


PRINT<anystring > 


Displays the text on the console. 


command;command.... 

Several NET commands are allowed on the same input line if 
they are separated by a semicolon. 

%filename 

Causes commands to be read in from the DOS filename speci- 
fied. 

NOECHO command 

Commands from a file (initiated by %filename) are usually 
displayed when they are executed; NOECHO suppresses this. 
2.3.2 The User Abort Key 

Under some conditions it is possible for a station to send com- 
mands to a station that does not exist or that does not accept 
commands. An example of this is setting the default file server 
(using the SET FS STN $NN command) to a station address 


that is not on the network. If a command is sent to a non- 
existent station, the NET program will, after 10 seconds, decide 
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the station is not there and will abandon the send. The user may 
choose to abort the send sooner by using the user abort key. 
This key is <Alt> 999 (hold down the <Alt> key press the 9 
key on the numeric pad 3 times, then release the <Alt> key). 
This abort key should be used with caution as it will abort any 
communications with another station, including commands, 
reads, and writes to the virtual volume. 


An example (user input in lower case; comments in 
parentheses): 


‘set fs stn $1 
(where stn 1 does not exist) 
“show dir 


(no response, so press <Alt>-999) 
99,User abort 

‘set fs stn $fe 

(set fs to a station that exists) 
:show dir 

(and try “show dir" again) 
/MAIN/USERS/ME 

0,0K 


2.4 Creating Virtual Volumes: the INIT Command 


To use a virtual volume under DOS, you must create the 
volume, using the file server, and format the volume for use 
under DOS. Use the INIT command of NET to do this. INIT per- 
forms the file server CREATE and the DOS FORMAT opera- 
tions. INIT is a “local” command: it cannot be issued through 
the NEST or NWCMDS utilities (Chapter 5), from the 
Messenger Mail program, or, preceded by "N", from the DOS 
command line. 


The INIT command has the following form (typed on one line): 
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INIT pathname,drive[,SIZE - size.unit][,SYS] 
[, ENTRIES =entries][, VOLNAME =name] 
[,protection][, usage] 


(available in IBM PC environments) 
Brackets indicate optional values. 
"Pathname” is the network name for the new volume. 


“Drive” is the drive letter of the drive on which INIT is to mount 
the new volume at creation so that it can be initialized. The drive 
letter must be followed by a colon. 


"SIZE" is the size in 512-byte blocks of the new volume. The 
default size is 720 blocks, which is equivalent to a standard 
360KB double-sided diskette. SIZE range is 10 to 65535 blocks, 
corresponding to virtual volume sizes of 5KB to 32MB. SIZE can 
also be specified in 256-byte sectors, characters, or kilobytes by 
specifying SIZE.S, SIZE.C, or SIZE.K. 


SYS causes the DOS system files (about 40 Kbytes) to be 
placed on the new volume, making the .volume bootable (See 
Section 1.10). 


"ENTRIES" specifies the number of entries to be allocated in the 
root directory. Default varies according to the size of the 
volume. Maximum for ENTRIES is 65,535. The value given for 
entries is rounded up to the next multiple of 16. If SYS option is 
specified, ENTRIES cannot be used because DOS assumes a 
directory size based on the size of the volume used during the 
boot process. 


The following table lists disk sizes and the number of root direc- 
tory entries for each size. The INIT command selects the smal- 
lest size greater than the size of the disk being created when 
deciding how many entries to put in the root directory of the 
volume. Note that subdirectories may contain up to 65535 
entries. 
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Size Directory 
(blocks) entries 
0-512 64 
513-2048 112 
2049-32680 512 
32681-65535 1024 


"VOLNAME" is the DOS name, if any, to be assigned to the new 
volume. 


“Protection” means that the volume can be protected by pass- 
words at the time that it is created (Chapter 3, PLAN Series 
Network Command Reference Manual). 


For example, to create and format a 1MB volume, you can type 
(on one line) 


INIT ,-MAIN/USERS/SAM, 1MB,F:, SIZE = 1024.K, 
VOLNAME =LARGE, ENTRIES =200 


“Usage” specifies the usage of the new volume on the specified 
drive once it has been initialized (as described in Chapters 3 
and 5 of the PLAN Series Network Command Reference 
Manual). A volume cannot be INiITed Read Only (RQ). 


INIT performs the following actions: 


(1) tries to create the volume /MAIN/USERS/SAM:IBM, type --|, 
SIZE = 1024 Kbytes. 


(2) If the pathname for the volume already exists, INIT will 
prompt you to confirm that you wish to format the virtual 
volume as a DOS disk: 


<pathname> already exists, OK to format (Y:N): 
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lf you answer "N", INIT will not format the virtual volume. 


If you answer "Y", INIT will format the volume making the 
assumption that it is to be of type "I" and of the specified 
size (either "size" from the command line, or 720 blocks if 
size is not specified). Therefore if you CREATE a virtual 
volume and then use INIT to format it, it is your responsibil- 
ity to ensure that the type is "I" and the specified size is 
correct. 


INIT tries to mount the volume in RW mode on the speci- 
fied drive. It must be able to do this in order to format the 
volume. If INIT is unable to mount the volume on the drive 
for this usage, it will issue the error message as returned by 
the file server and quit. 


INIT will write the necessary record and directory informa- 
tion on the volume to match the size specified. If the 
ENTRIES option is given, the value “entries” is taken as the 
number of entries to be put in the root directory. The 
defaults, f ENTRIES is not given, are 64 entries for 


volumes up to 512 blocks, 112 for. volumes up to 2048 


blocks, 256 for volumes up to 8192 blocks, 512 for volumes 
up to 32680 blocks, and 1024 for all sizes above 32680 
blocks. Maximum for ENTRIES is 65,535. The value given 
for entries is rounded up to the next multiple of 16. If SYS 
option is specified, ENTRIES cannot be used. 


If you have specified the “SYS” keyword, INIT will also copy 
system fies IBMBIO.COM, IBMDOS.COM and 
COMMAND.COM from the current default drive. If you 
leave out the "SYS" keyword, these files will not be copied 
across. 


INIT also copies a boot record from the current drive to the 
new drive if you have specified the SYS option. A boot 
record is a block stored in the first sector (block 0) of a 
floppy disk or virtual disk. The boot record boots the operat- 
ing system on the disk. It must be present to boot from the 
network. If your current default drive does not have a boot 
record, the INIT command asks you for the drive letter of a 
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drive that has the boot record. The boot record is the same 
as that stored on diskettes, so the driver letter may be any 
real or virtual disk. Diskettes always have this record. Vir- 
tual volumes may or may not have it, depending on whether 
or not they were INITed with the SYS option. 


(6) When INIT exits successfully, it leaves the newly formatted 
drive mounted for RW,UPD usage on the specified drive. 
SHR or EXC can also be specified. A volume cannot be 
mounted RO by the INIT command. 


(7) When INIT gets an error on a previously existing volume, tt 
attempts to preserve the original state of the volume. If 
INIT gets an error on a newly created volume, the new 
volume will be unmounted and deleted. This may fail if you 
have set a password for the file. 


WARNING: Do not format the disk with the DOS FORMAT 
program. The DOS FORMAT utility will not accept virtual 
volumes of any size (even real diskette size). 


We recommend that you use the INIT command to create and 
format all I-type virtual volumes. Use the CREATE command to 
create virtual volumes of types other than "I" (type "T" volumes, 
for example), which are not specific to the DOS operating sys- 
tem. 


Note that the size of the created volume may be slightly larger 
than the size you specify. This expansion is to insure that the 
newly created volume will contain the amount of space you have 
specified for data in addition to any “overhead” space that DOS 
requires. For example, if you specify a size of about 2000 blocks 
(for a 1MB volume), the size will be rounded up to a multiple of 
8. This action is due to DOS file-accessing techniques. 


WARNING: The DOS command ASSIGN should NOT be 
used with the network. The ASSIGN command works only in 
systems employing eight drives or less. If your system 
employs more than eight drives, using the ASSIGN com- 
mand can destroy data on your volumes. 
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2.4.1 INIT with Previous Versions of DOS and DOS 3.10 


Since some software packages do not work under DOS 3.10, 
other versions of DOS (after DOS version 2.00) can be used 
simultaneously at different work stations. For example, volumes 
INITed while in DOS 2.10 can be read and written while in DOS 
3.10. Volumes INITed in DOS 3.10 can be read and written 
while in DOS 2.10. 


Note that programs distributed on the DOS 2.00, 2.10, and 3.00 
library volume will not run under DOS 3.10. However, programs 
distributed on the DOS 3.10 library volume will run under DOS 
version 2.00, 2.10, 3.00, and 3.10. 


Another difference occurs when INITing a boot volume with the 
SYS option (see Section 2.4). If the current drive contains DOS 
2.10 when the INIT command is given, the new volume will boot 
into DOS 2.10. If the current drive contains DOS 3.10 when the 
INIT command is given, the new volume will boot into DOS 
3.10. The volume can be read or written while booted (from 
another volume) into either version of DOS, but, when booted, 
the version of DOS available is the one on that volume. 


WARNING: Do not use the SYS command to copy DOS 3.10 
onto a DOS 2.10 hard disk or virtual volume. If this pro- 
cedure is used, the volume will NOT be usable. A new 
volume should be INITed with the SYS option; then the files 
should be copied from the old volume to the new volume. 


2.5 Using Virtual Volumes In DOS 


Suppose that you need to write new programs or run existing 
ones on the system. What must you do to get started? 


Use the NET program's INIT command to create and format a 
DOS virtual volume, selecting a drive in the range D: through Z: 
(assuming that drives A: through C: are being used for floppy 
disks and a local hard disk). 
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Use the DOS COPY command to copy files from a real disk 
inserted in one of the user station diskette drives to the new vir- 
tual volume if desired. 


To move text files from virtual volumes in this environment to 
virtual volumes in other workstation/operating system environ- 
ments (and vice versa), use the TCOPY utility program 
described in Chapter 5. 


Use the normal DOS system software to create, to compile, and 
to link programs, just as on a standalone IBM Personal Com- 
puter. 


For a list of DOS files distributed on the shared library volume 
/MAIN/LIB. |BMPC/DOS, see Appendix C. 


For example, suppose that an educator has a set of arithmetic 
courses that he previously ran on a standalone IBM Personal 
Computer. Now he wants to present these same courses on the 
network. 


Let's assume that he is authorized to allocate space on the 
shared disk /MAIN in the directory COURSES. He wants to 
create a bootable virtual volume called ARITHMETIC on it. He 
would run the NET program and use the INIT command: 


INIT /MAIN/COURSES/ARITHMETIC,F:,SYS 


(Assume that no protection of the new virtual volume is desired 
and that the size of a real diskette is satisfactory.) 


Then, using the DOS COPY command, he would transfer files 
from the real disk to the new virtual disk. 


WARNING: The DOS commands DISKCOPY and 
DISKCOMP do not work with network volumes. If the 
DISKCOPY and DISKCOMP commands are used, the 
response will be "Invalid Drive Specification.” 
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2.6 Shadow™ File Server 

Users may wish to have their work saved onto two file servers 
simultaneously. The second (Shadow) file server acts as a 
backup so that no data is lost if an error occurs in a transaction 
with the primary file server or if either file server crashes. 


The following sections discuss: 


— primary and secondary file servers: a recapitulation of 
information on drives and command channels (2.6.1) 


— how to turn the Shadow on and off (2.6.2) 
— getting started (2.6.3) 


— recovery when one file server crashes or returns an error 
(2.6.4) 


— invoking the Shadow automatically (2.6.5) 


2.6.1 Default (Primary) File Server 


This section recapitulates information, previously presented, 
relevant to Shadow file server use. 


File server commands issued at the workstation are sent to the 
current default file server on the network. At startup the file 
server that contains the workstation’s startup profile is the 
default file server. 


To change the default file server, issue the file server com- 
mand 


@$NN 
The file server with the address $NN is the new default file 
server. All subsequent file server commands will be sent to that 


file server. 
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The "command channel" is defined as this default relationship 
between workstation and default file server: commands to the 
file server and responses from it to the workstation follow the 
current command channel (commands are sent to $NN and 
responses are returned by $NN) . 


Sending File Server Commands 


File server commands are sent from a workstation by a program 
or interactively from the keyboard. The commands are issued 
(1) from the NET program, or (2) from an application program or 
from the DOS prompt when preceded by "NEST": 


E > NEST MOUNT /MAIN/EXAMPLE 


or (3) from the NWCMDS window, which is invoked from the 
DOS prompt by pressing <Ctrl>- F. 


To send a single file server command to a file server other 
than the current default file server, precede the command by 
(a$nn. For example, from DOS 


E> NEST @$NN <command> 


Drives and Their Command Channels 


Volumes are mounted by the MOUNT, CREATE, and INIT com- 
mands. These commands are sent to the current default file 
server or to another file server if preceded by "@$nn": all sub- 
sequent input and output relating to the drive will be sent to the 
file server last communicated with. 


2.6.2 Turning the Secondary File Server On and Off 
This section presents the basic Shadow commands (Table 2-1) 


and concepts. Shadow strategy and use are discussed in the 
following sections. Use this section for reference. 
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Table 2-1 


Commands Used with the Shadow 


Command 


SNN 


(@$NN <command> 


&$nn 


&$nn <command> 


(a$NN &$nn 


Purpose 


Changes the default file server to 
$NN or turns off the secondary file 
server (the file server that is not $NN). 


Changes the default file server for 
one command or turns off shadow- 
ing for one network command. 


Turns on the secondary file server 
$nn. Primary server is same as 
default file server. 


Turns on the secondary file server 
$nn for one network command. 
Primary file server is same as default 
file server. 


Turns on or resets the primary and 
secondary file servers to $NN and 
$nn respectively. 


«$NN &$nn <command> Turns on or resets the 


?d 


Idxyxy 


primary and secondary file servers 
to $NN and $nn respectively for one 
network command. 


Returns primary and secondary 
usage and error information for 
drive D:. 


Changes primary and secondary 
read, write usage for drive D:. 
(Table 2-2) 
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To turn on a secondary file server, where $nn is the address 
of the secondary file server, issue the file server command &$nn 
from the NET program, NEST utility, NWCMD window, or DOS 
prompt. For example, from the DOS prompt, enter 

E> NEST &$NN 
or 


E> NEST &$nn 


All subsequent file server commands that you issue will be sent 
to both file servers. 


Any mounts that have occured before a secondary file server is 
turned on refer only to the primary file server. 
To turn off a secondary file server, issue the command 
@SNN 
or 
SET FS $NN 


where $NN is the address of the primary file server. 


Changing both primary and secondary file servers 


To change both primary and secondary file servers, issue the 
command 


@$NN &$nn 
(NN and nn are used to differentiate the file servers in the 


examples given; the use of capital and lower case has no other 
significance.) 
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Issuing selected commands to a secondary file server 


To shadow a single file server command, precede the command 
by &$nn: 


&$nn <command - 


Volumes with different pathnames on primary and secon- 
dary file servers 


If you want volumes with different network pathnames to mount 
on primary and secondary file server drives, preface the com- 
mand that mounts them by "@$NN" for the primary and "&$nn" 
for the secondary file server and use the command twice. For 
example: 


($FE MOUNT .ALT/USERS/DATA,RW,F: 

&$FD MOUNT /MAIN/USERS;/SHADOWDATA,RW,F: 
The two volumes can have different names, but their drive 
letters, volume sizes (network and DOS), types, and usages 
must be identical. Otherwise the error message 

204,Secondary volume is not the same as primary 
will be returned. 
With the secondary file server turned on, data is read from a 
volume mounted on a primary file server drive but written to two 


volumes: one on a primary file server drive and one on a 
secondary file server drive. 


Primary and Secondary Volumes Must Be Identical 


Shadowed volumes, although they may have different path- 
names, must be identical in all other respects. It is not sufficient 
to INIT a secondary volume equal in size to primary volume and 
use the DOS Copy Command to move files to it. See Section 
2.6.3 (“Getting Started") for ways to create identical volumes. 
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2.6.2.1 Turning a File Server Off or Changing the 
Shadowing Specific Drives: the ! Command 


It is frequently necessary to turn shadowing off for a particular 
drive (as discussed below in "Recovering from File Server 
Crashes”). To turn off shadowing for a particular file server or 
to change the nature of the shadowing, issue an “!" command: 


!dxyxy 


where d is the drive, x is either “R” or "-", and y is either “W” or 
"." (r, w, and - are defined in the text and table below). 


The first xy pair represents the primary file server, and the 
second xy pair represents the secondary file server (see Table 
2-1). 


lf an "R" appears in place of the x, the Read of data will be done 
from that file server. If both x's are set to "R", the error 


201,Missing or invalid Read/Write code 
is returned. 


If a "-" appears in place of the x, no Read is done from that file 
server. 


If a "W” appears for one of the y's, the Write is done to that file 
server. If both y's are "W", the Write is done to both file servers. 
if a "-" appears for either y, the data is not written to that file 
server. 


The default for a mount is RW-W (read from primary and write 
to both primary and secondary) if the secondary file server is 
used. For a single file server the default is RW--. The current 
status is reported in the PS (for Primary status) and SS (for 
Secondary status) fields of the ?d command. 
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Table 2-2 


= Id xyxy Syntax 


RW 


RW 


RW 


Meaning 


Read data from primary 
Write data to primary and 
secondary (default when 
using Shadow) 

Read data from primary 
Write data to primary 
(turn off secondary 
default when not using 
Shadow) 

Read data from primary 
Write data to secondary 


Read data from secondary 


Write data to primary and 
secondary 


Read data from secondary 


Write data to secondary 
(turn off primary) 
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2.6.2.2 Differences Between Drive Usage (the ! Command) 
and Command Channel Usage 


A Concept Necessary to Remember: 


Any given drive can be reset in its usage relationship to a file 
server by using the “!” command. For example. issuing the net- 
work command 


tERW-W 
causes (for operations on drive E:) data to be read from the pri- 
mary file server and data to be written to the primary and secon- 
dary file server. Issuing a command such as 

tE --RW 
effectively turns off the primary file server and causes read and 
write operations to occur for drive E: only on the secondary file 
server. 


Such is not the case for the command channel. 


For the command channel there is always a primary file server. 
For example, suppose that the command 


@$FE&$FD 
has been issued. $FE is the primary file server and $FD is the 
secondary file server. If the primary file server is to be turned off 
and the secondary is to continue alone, the command 


@$FD 


must be issued, and $FD now becomes the primary file server 
for all future commands. 
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Drives currently set to read from $FE and to write to $FE and 
$FD can now be reset to read and write from the secondary file 
server using 


1D --RW 


or the command channel for the drive can be left as it was origi- 
nally ($FE primary, $FD secondary), and the drive usage can be 
changed to read,write for secondary only via 


td --rw 


In other words using the command (a$FD to change the com- 
mand channel's primary file server from $FE to $FD will not 
change the current primary and secondary file servers for any 
drive currently mounted. 


2.6.3 Getting Started 


(For automatic startup and for startup error recovery. see Sec- 
tion 2.6.5) ° 


The first step in using the Shadow must always be to create 
identical volumes on both file servers. It is not sufficient to INIT 
a secondary volume equal in size to the primary volume and 
use the DOS Copy Command to move files to it. 


Warning: The Shadow does not check that the contents of 
the primary and secondary volumes are identical, only that 
they are the same size. Using the Shadow on two volumes 
that are not identical may destroy data on one or both. 
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To create identical Shadow volumes 


Three methods: 


(1) 


(2) 
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Creating identical volumes using the file server utility Partial 
Tape Dump Restore 


Step 1: Dump the volumes to be mirrored from the primary 
file server 


From the primary file server utility menu select the Partial 
Tape Dump/Restore utility option. Follow the prompts to 
dump the volumes to be mirrored from the file server onto a 
backup tape. 


Step 2: Restore the volumes to be mirrored to the secon- 
dary file server 


From the secondary file server utility menu select the Par- 
tial Tape Dump-Restore option. Follow the prompts to 
restore from tape to the secondary file server the tapes to 
be mirrored. 


For more information on the Partial Tape Dump/Restore 
utility, see Section 4.1 of the Plan Series File Server Instal- 
lation and Operations Manual. 


Creating identical volumes using the File Transfer Server 


Use FTS to transfer all volumes to shadowed onto the 
secondary file server. Secondary file server pathnames of 
these volumes need not be the same as their primary path- 
names. 
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To transfer the volumes use the SEND VOL command, tak- 
ing special care to specifiy server and destination file 
servers correctly: 


SEND VOL «.pathnames>, STN $NN, 


VOL <pathname>, STN $nn; 


where $NN is the address of the source file server and 
&$nn the address of the destination file server. For more 
information on FTS see the PLAN Series File Transfer 
Server Installation and Operations Manual. 


(3) Creating identical volumes using the INIT command and the 
Shadow. 


Turn on the secondary file server by issuing the NET com- 
mand "@$NN&$nn". 


Issue an INIT command. The volume with pathname, size, 
and protection specified will be created simultaneously on 
primary and secondary file servers. After INIT is complete. 
you can immediately copy data to the shadowed volumes. 


2.6.4 Interruptions in Shadow Operation: Recovery from 
Errors 


Shadow facilities do not include automatic error recovery. Appli- 
cation programs that use shadowing must provide such 
recovery. This section provides information to be used when 
designing error recovery software for applications using shadow- 
ing. 


NETWORK 


Shadowed network operations may be interrupted by: 


(1) an incapacitated file server (2.8.4.1.1) 
(2) network problems (such as a slow file server) (2.8.4.1.2) 


(3) a disk |:0 error caused by a media problem (bad area on a 
disk) (2.8.4.1 3) 


To recover from an interruption you must 


(1) correct the problem and retry, or 
(2) turn off one file server. 


These choices are discussed below in conjunction with the 
causes of Shadow interruption. 


Responses differ 


When a network command is issued, the command is sent to 
both the primary and the secondary file server. When responses 
are returned from each, the response codes are compared. If 
they are the same, the response code and the response line 
from the primary file server are displayed. 


If the response codes from the two file servers differ for a given 
transaction, both responses are returned. The response lines 
from primary and secondary file servers are prefixed with a “—" 
and suffixed with "($nn)", where $nn is the hexadecimal station 
address of the file server in question. For example, such a tran- 
saction would look like the following: 


LOCK SPECIAL (command to file servers) 
—0,OK ($FE) (response from primary, $FE) 
—41,IN EXC USE ($FD) (response from secondary, $FD) 


+200,Responses different 
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2.6.4.1 Causes of Interruption; Choice of Recovery 


2.6.4.1.1 incapacitated File Server 


lf a file server hangs, will not talk to other stations on the net- 
work, or is otherwise incapacitated, shadowing operations that 
invoke that file server halt until the problem is fixed. 


Determine whether the problem can be fixed quickly or will take 
some time to fix (use Chapters 3 to 6 of the PLAN Series Ser 
vice Manual for this). If the problem can be fixed quickly, stop 
application work at the workstations until the file server is 
operating again. Then resume work in shadowing mode. See 
Section 2.6.4 for more information. 


if file server goes down during a write-operation so that 
volumes on two file servers are no longer identical, the 
volumes must be made identical again before operations 
can proceed. 


2.6.4.1.2 Network Timeout 


If a file server is busy, it may return a “98, Network Timeout” 
message (PE =- 10 or SE = 10, Section 2.6.5) in response to a 
network command (network |,0 from a workstation). In this case 
one file server responds to the network command while the 
other file server returns the “Network Timeout” message. The 
Shadow then adds a “200, Responses Differ” message (see 
also Section 2.6.4). 


If the network command involves a write to a volume, and one 
file server “times out” while the other successfully writes to the 
volume in question, then the primary and secondary volumes 
are no longer identical, and the operaton cannot be retried. 
Remove the file server that has timed out from primary or 
secondary mode and continue with the other file sever until the 
volumes affected have been made identical once again. 
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2.6.4.1.3 Disk 1/0 Error; Media Problem 


If during a disk |,0 operation the primary or secondary file server 
returns a disk |.0 error (PE = 08 or SE = 08, Section 2.6.4.1.2). 
halt operations on that file server until the disk is fixed. 


The initial error information will be supplied by INT 24 (interrupt 
24), the critical error handler vector (IBM DOS Version 3.10 
Technical Reference). 


The registers that you have supplied to the interrupt 21 call that 
causes the error are sent to interrupt 24 on the stack. 


If an error occurs during a read, no data is read, and the 
appropriate error code and message are returned. If an error 
occurs during a write to one of the file servers, an error code 
and message are returned, and a write is attempted to the other 
file server. If both writes fail, the primary file server error code 
and message are returned. 


Use the local command "?" (Section 2.6.1) for more information 
about drive N: when an error message is returned. 


The two most common errors are “network timeouts” (2.6.4.1.2) 
and "data errors". Both of these can be retried. 


If a read error occurs, primary and secondary volumes remain 
identical. 


lf a write error occurs, the two volumes in question are no 
longer identical. Shadowing must be terminated immediately for 
drives not identical and not resumed until the two volumes are 
once more identical. 


Examples: 


(1) A LOCK command fails because the lock is temporarily set 
by a different application or because a network timeout is 
caused by a transient network condition. 
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The LOCK command should be reissued to the failed file 
server; or the successful LOCK on the other file server 
should be unlocked, and the application set program should 
take some alternate action. 


The primary file server is missing the data volume 
,MAIN:DATA EXAMPLE. 


A mount command is issued in an application program and 
the file servers respond: 


E> NET MOUNT /MAIN/DATA/EXAMPLE,RW,E: 
-102, FILE NOT FOUND ($FE) 
-0, OK ($FD) 
+200, RESPONSES DIFFERENT 


We assume that a retry in this situation would be fruitless; 
so 


(a) the primary file server must be turned off for the 
application, with operations continuing on the 
secondary, 


(b) or the application must pause while the problem is 
remedied (in this case, missing volume restored). 


To turn off the primary, issue 

E> NET (u $FD 

E> NET 'E--RW 
The command channel is reset to $FD-only, and the pri- 
mary file server is turned off for drive E:. If other drives are 
involved, they must also be changed via the “'” command. 
The primary file server can be turned back on after the 


missing data volume is restored to it using one of the 
methods described in Section 2.6.3. 
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(3) An application program traps a disk I/O error on drive H:. 
The "?" command is issued. The 72 response: 


E> NET ?H 


72, FS=$FE, SFS=$FD, T=1,RW,SHR,SIZE = 500.b, 
PS=RW,PE =0,SS=rw,SE = 10 


Here the volume on drive H: is mounted on the primary file 
server $FE for RW,SHR usage. It is a type | volume of 500 
blocks. 


It is being shadowed on file server $FD. Data is read from 
$FE and written to $FE and $FD. The last read. write opera- 
tion was successful on $FE but returned a disk O error 
(error 08) from $FD. 


$FD must be turned off: 
E> NET«&$FE 


until the volume in question is recreated on $FD using one 
of the methods described in Section 2.6.3. 


If the operation returning the error is a read operation, a 
retry might be appropriate after issuing the “!” command. 


E> NET!IHRW-W 


Here drive H: is changed so that $FD writes to the volume 
only and does not read from it. 


2.6.5 Automatic Startup for Shadowing 


To start up and shadow an applications program automatically, 
first boot DOS. Snadow commands cannot be issued until DOS 
has been loaded. (Shadow commands are supported by the 
MENU command but not by the BOOT command.) Next issue 
Shadow commands using AUTOEXEC.BAT and MENU.BAT 
files as shown below. 
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Profile $nn (where $nn refers to SYSTEM: PROFILE;$nn, with 
$nn the station address) contains the lines: 


MOUNT ‘MAIN.LIB,IBMPC DOS,C: 
MOUNT -MAIN- USERS. DATA,E:. RW 
BOOT E: 


NOTE: Shadow commands are not supported by the BOOT 
program, only by the MENU command. 


AUTOEXEC.BAT on E: contains the line: 
MENU <name> 


(where <name> is :SYSTEM/PROFILE., NAME). 


Profile name contains the lines: 


MENU 

> Turn on shadowing 
(u $FE $FD i 
MOUNT ‘MAIN, USERS. DATA,E:,RW 
BOOT E: 


> Run applications without shadowing 
MOUNT ‘MAIN: USERS, DATA,E:,RW 
BOOT E: 


In this scheme DOS is booted from the library volume on drive 
C: at startup. Commands in the AUTOEXEC.BAT file on drives 
C: and E: are executed. AUTOEXEC.BAT invokes the distri- 
buted MENU.BAT file (Chapter 6), which executes the com- 
mands in the profile NAME. 


"NAME" contains two menu items. Both remount the user 
volume and log on to it, one with both $FE and $FD turned on, 
the other with only the file server that originally booted the 
workstation. 
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If either file server is down, an "Abort, Retry, Ignore?” message 
will be returned when the (u $FE &$FD line is reached. Press "I" 
for “Ignore” to continue with one file server. 


The profiles "$nn" and NAME (or whatever you choose to call 


them) should be put on both $FE and $FD. If either file server is 
down, work can continue on the other. 


2.6.6 Considerations for Shadow Use with Network 
Application Programs 

2.6.6.1 Virtual Printer 

' Virtual Print requests will be spooled on the primary file server. 

If the primary file server goes down before the spooled file is 

closed (by «<Alt> 222 for example), the spooled material may 


be lost. The secondary file server does not play a part in virtual 
printing. 


2.6.6.2 The Messenger™ 


Shadowing should not be used in conjunction with the 
Messenger unless 


(1) sender and receiver both use the Shadow, and 


(2) all messages are to be shadowed. 


2.6.6.3 NET/NEST 


There are Shadow considerations beyond those discussed in 
previous sections. (NET can be used to create identical Sha- 
dow volumes, Section 2.6.3.) 
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2.6.6.4 TCOPY 

If the default server is set to both a server and its Shadow, 

TCOPY will generate a shadowed file and read it back from 

either. 

2.6.6.5 File Transfer Server 

FTS can be used to create identical Shadow volumes (Section 

2.6.3). 

2.6.6.6 COUNT, 3278 Emulator, SETPRINT, PRINTQ, 
CARDCHK 


There are no Shadow implications when using these utilities. 
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Chapter 3 


Printing 


3.0 Introduction 


This chapter provides information on print servers (see Section 
3.1) and on two shared network printing options available to 
users: 


Virtual Printer Section 3.2 
Network Print Request Program (NPRINT) Section 3.3 


If your network does not have a print server installed, Sec- 
tions 3.1, 3.2 and 3.3 do not apply to you. See Section 3.4 
on Local Printers. 


The virtual printer is software that allows the user to employ 
the DOS COPY command to send files and keyboard input to a 
network printer (just as he would send input from a standalone 
computer to a local printer). The input is then spooled (written 
to a temporary file) to be printed in its turn by a network printer. 


The network print request program (NPRINT) is software that 
allows the user to specify files (usually non-DOS) from network 
volumes to be printed on network printers when use of the DOS 
COPY command is inconvenient. 


For a comparison of the Virtual Printer and NPRINT, see Table 
3-1. 


Once a print request has been queued, the user can track the 
request with PRINTQ, a program run on an IBM PC DOS 
workstation which displays master queue information. See Sec- 
tion 3.5. 
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Table 3-1 


A Comparison of NPRINT and the Virtual Printer 


NPRINT 


1. To request a printuut, run 


NPRINT to specify files to 
be printed, volumes that 
contain the files, and 
other options. 

Default values can 

be set. 


2. To print, say "YES" to 


"ISSUE PRINT 
REQUEST?" 


3. Prints several types of 


files (IBM DOS, 
p-System; Apple // DOS, 
Pascal, CP/M; Apple /// 
SOS, etc). 


4. Volumes that contain 
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files to be printed 
need not be mounted. 


Virtual Printer 


1. To print a file, use the 


DOS COPY command. 
Default values for printer, 
header ID page, user 
name, and other options 
can be set using 
SETPRINT, or print 
parameters can be se! 
by entering escape 
sequences 


2. To print, you du in: 


have to do anything it 
no data is sent to 

the virtual printer for 

15 seconds, the virtual 

printer will automatically 
close itself. 


3. Prints only IBM PC DOS 


files. 


4. Volumes that contain 


files to be printed 
must be mounted. 
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NPRINT Virtual Printer 

5. Files from local devices 5. Files from local devices 
will not be printed. will be printed. 

6. NPRINT is a separate 6. VPRINT looks like a real 
program Applications printer to DOS. 
such as SuperCalc3 Application programs 
cannot print to it. such as SuperCalc3 can 
must print to a file. print to it. 


You may then exit the 
application and use 


NPRINT. 

7. NPRINT is not sup- 7. Virtual Printer is 
ported by the Print supported by the Print 
Server Feature Card. Server Feature Card. 
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3.1 Print Servers 
The Print Server Programs 


The Print Server package -onsists of user and server programs. 
The user software which is invoked by users at their worksta- 
tions, allows data to be spooled (put into files that wait to be 
printed) using the DOS COPY command, or it presents a print 
request form on the screen (NPRINT). Spooled data and print 
requests are sent to the file server's hard disk where it waits as 
a virtual volume. The server software processes these volumes 
and manages the printing of requests. 


The Print Server Station 


A print server station is a standalone computer or a Print Server 
Feature Card located inside a file server that runs special print 
server software. The programs running on these stations check 
the request queues on the hard disk periodically, taking 
requests in the order. they were issued but considering special 
user specified priorities. The print server software verifies that a 
printer is available and set up to do the job. If it is, the job is 
completed. See Figure 3-1. 


User Specified Printer "Setups" 


A printer is capable of printing according to varying length-of- 
page specifications on different types of paper and, in some 
cases, in different fonts. Users specify in their spooled data or 
print requests which printer “setup” they want. The print server 
will check to see if that particular “setup” specification is sup- 
ported on the specified printer. If it is not, the print server will 
delay the request until instructed by you that the setup is 
currently available. Meanwhile, users who have other currently 
supported preferences can issue requests that can be printed 
almost directly. 


There are many characteristics that determine a “setup.” You 
can create specifications at your installation for all the needed 
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setups and give names to them. These names are then 
employed by the user when the print jobs are ‘ssued and by the 
server program when the requests are processeu 


Multiple Printers and Multiple Setups 


One print server can manage more than one printer. In fact a 
network can have more than one print server, each connected 
to multiple printers. The user request form allows a user to 
select a particular print server and even a particular printer to do 
the print job. If the user does not have a printer preference, he 
can specify “ANY” and the first free server will process the 
request, directing it to be printed on its first available printer. 


Multiple File Servers 


Some networks have more than one file server. Each file server 
controls its own hard disks. The print servers can check with 
each file server on the network for jobs to be printed. 


The user can specify that files be printed: from any file server in 
the network that for which you have provided him access Print 
jobs that are queued on a default file server can specify files to 
be printed that reside on other file servers. 


The user will need to know which file servers are serviced by 
which print servers in your system. 
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Figure 3-1 


The Course of a Print Request 
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3.2 Virtual Printer 


The virtual printer is a chara: ter device that will accept text and 
write it to a file server volume on the primary file server for that 
station. A print server can then print the text from this volume. 
Any number of stations can generate such volumes simultane- 
ously. and one or more print servers var service the queues of 
volumes waiting to be printed. 


The virtual printer is used to redirect the output of various user 
utility and application programs, such as compilers and some 
word processors, to a network printer instead of a to local 
printer. Virtual printers are also useful for listing files on local 
disks to a network printer. 


3.2.1 Using the Virtual Printer 

The network driver, as distributed, includes a virtual printer dev- 
ice named LPT1 (alias PRN). The virtual printer (see Figure 3-2: 
can also always be accessed under the name LPT3. To get a 


printout. use the command 


COPY filename LPT1 (or PRN or LPT3) 


Figure 3-2 


Virtual Printer Only 


WORKSTATION 


Fann =) 







copy filename LPT1 
(or PRN or LPT3) 










VIRTUAL SPOOLED 
NETWORK PRINTER 
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After issuing the COPY command, the virtual printer 
will close automatically after 15 seconds. 


To echo all characters appearing on the screen to the virtual 
printer, press < Shift -<PrtSc>. To echo all characters continu- 
ously from the screen to the virtual printer. press 
< Ctri=~PrtSc= to start and -Ctrl><PrtSc:- again to stop. In 
both cases the virtual printer will close after 15 seconds of no 
printing. The ~Shift><PrtSc> and <Ctric-~:PrtSc keys 
always write to the printer device named LPT1, whether local or 
virtual. 


The NETCONFG program can be used to rename the virtual 
printer device VPRN (alias VPRN2) when a local printing device 
is also present (see Section 3.4.2). The NETCNFG program can 
also be used to change the time until the printer closes or to dis- 
able the < Alt 222 and timeout completely. 


Names that correspond to the virtual printer: 


As shipped After using 
NETCONFG 
LPT1 VPRN 
PRN VPRN2 
LPT3 LPT3 


3.2.2 How the Virtual Printer Works 


The virtual printer device accumulates characters in a character 
buffer that it writes, when the buffer is full, to a volume it has 
created in the -SYSTEM/QUEUE’TMP directory on the file 
server. Because DOS cannot tell the printer driver when to close 
the virtual printer and flush the buffer, the driver must be closed. 
Closure will occur after 15 seconds of no activity or it can be 
done explicitly by using <~ Alt> 222 on the keyboard or by send- 
ing - Esc:- V.C to the virtual printer. 


When the driver is closed, the volume is moved to 
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SYSTEM. QUEUE NEW MMDDHHMMSS.$nn 


after unmounting (nn is the station number in hex, and 
MMDDHHMMSS is the time the request was made). 


3.2.3 The Header 


In addition to the data buffer for accumulating characters to be 
printed, the virtual print driver has a buffer containing the header 
to be written at the beginning of the spooled volume. Initially the 
header buffer contains four lines: 


REQTYPE:PRINT 
STATION:$nn 
TITLELINE:NO 
SPOOLED:DATA 


Each is terminated with a carriage return. 


3.2.4 Specifying Header Values for Spooled Requests 
Using NWCMDS and VPCMDS — 


In order to send virtual printer escape sequences from the key- 
board, you must use the NWCMDS program (or the VPCMDS 
program). This program is installed after you boot your 
machine, and from then on it is available to you by typing a spe- 
cial character (the “trigger” character) on your keyboard. 


In order to send an escape sequence, type the trigger character 
and wait for the command window to appear. If you are using 
VPCMDS, the prompt VPRINT: will be displayed in the window. 
If you are using NWCMDS, the colon wiil be displayed; and you 
must then type (F10) in order for the VPRINT: prompt to show. 


Once the VPRINT: prompt appears, you can type any of the 
escape sequences without the leading - .esc-v -. Any of the vir- 
tual printer header keywords can by typed, as well as the “local” 
commands. eg. .r to reset the header to its default or .c to close 
the virtual printer. 
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Note that with the exception of .p (change pathname) and .c the 
escape sequences do not affect any currently open virtual print 
files. In order to guarantee that any escape sequence you type 
takes effect immediately, you should type .c to close the virtual 
print file and then type the escape sequences 


For example, if you want to make ten copies of a report on a 
draft printer set up your default virtual printer to print one copy 
of a letter quality printer, type the trigger character to get the 
NWCMDS window, type (F10) to get the VPRINT: prompt, and 


type: 


VPRINT:.c closes the current virtual print file 
VPRINT:COPIES:10 requests ten copies 
VPRINT:SETUP:DRAFT requests the draft printer 
VPRINT:q escapes from the VPCMDS or 


NWCMDS window 


Now that you have set up your virtual printer to print ten copies 
on the draft printer, each time you send a report to the virtual 
printer it will print the ten copies. In order to reset the virtaul 
printer to print a single copy on the letter quality, enter 
NWCMDS (or VPCMDS) and type: 


VPRINT:.c closes any currently open virtual print file 
VPRINT:r resets the virtual print parameters to their 
defaults 


Note that if you change your virtual printer parameters a lot, you 
should periodically issue the .r command to reset the parame- 
ters. Otherwise, each change you make will be added to the 
previous changes and overflow the virtual printer header buffer. 


For further information on the VPCMD, see section 5.5.2.2 of 
this manual. 
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3.2.5 Specifying Header Values for Spooled Requests: 
the SETPRINT Program 
The SETPRINT program allows the user to specify header items 
and write them directly to a virtual printer or to a file for use 
later. 
To use the program, type 


C:SETPRINT 


assuming that the shared network library volume is mounted on 
drive C:. 


The program allows you to specify either a virtual printer or 
setup file. 


Enter the name of the virtual printer or output (setup) file to 
receive these header items. Default is LPT3 (the virtual printer). 


Available header items are: 


Header Page ID Priority 


User Name Page Title 

Print Server Page Numbering (yes, no) 
Printer Model Eject 

Printer Setup Copies 


These parameters and their defaults are defined in Section 
3.2.5. 


When finished, type ~ Esc--. You will be asked if you wish to 
save the parameters as entered. Type "Y". 


If you save the parameters to a file (called EXAMPLE. for 
instance) and subsequently type 


C:SETPRINT EXAMPLE 


the parameters saved will be used as defaults in the SETPRINT 
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menu. In this way you can create and save multiple header files, 
which you can copy to the virtual printer later. as needed, using 
SETPRINT or the command 

COPY filename LPT3 


(or, instead of LPT3, some other virtual printer name). 


3.2.6 Header Items 

Most header items can be specified using the SETPRINT pro- 
gram. To change a header item not handled by SETPRINT, 
such as TAG or DATE, you must send explicit instructions to the 
virtual printer using escape sequences. See Section 3.2.7 

Some escape sequences change the header. When the virtual 
print file is opened, the current contents of the header, followed 
by an extra carriage return (null line), are moved to the data 
buffer to be written as the initial part of the file. After the virtual 
print file is closed, the header remains as is until changed by 
subsequent escape sequences. 

Keyword:value 

REQTYPE:PRINT [required] 


This must be the first line of the request. 
ID:<name= [optional] 
<name> will be printed in block letters on the header page. 


Maximum length is 15 characters. 


USER:<name> [optional] 


Will be printed as ID name if ID is not specified. 
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NAME:<name `> [optional] 


Name field to be printed on the header page, 80 characters 
maximum. If not specified, USER name is used. 


STATION: «x number - [optional] 


Station address, decimal or $hex, will become ID name if no ID 
or USER is specified. SETPRINT always writes out this header 
item with your station address (in hexadecimal). SETPRINT will 
not change it. 


DATE:< timestamp- [optional] 

<timestamp> in YYMMDDHHMMSSW format is the time the 
request was issued and will be used to insert the request in the 
wait queue. If not specified, time used will be the time the 
request is entered into the queue. (Not specified by SETPRINT.) 
TITLELINE:{YES | NO } [optional] ` 

lf YES, date and page numbers will be printed at top of each 
page. NO suppresses page titles. SETPRINT defaults to "NO". 
TITLE:<title> [optional] 

<title> will be printed along with date and page numbers at top 
of each page. If this exists, TITLELINE need not be specified. 
Maximum length is 31 characters. 

TAG: =< identifier- [optional] 


Identifies the request entry in the print queue. Maximum length 
is 40 characters. (Not specified by SETPRINT.) 
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SERVER:{- name - ANY! [optional] 

Name of the print server to service the request. Maximum 
length is 15 characters. If <name> is ANY, any free print 
server will service the request. If no server is specified. ANY is 
assumed. 

PRINTER:<<model> [optional] 

Model name of the printer to use. Maximum length is 15 charac- 
ters. If ANY, any free printer will be used. If not specified, ANY 
is assumed. 

SETUP:<forms. [optional] 

Print format to use. Maximum length is 15 characters. Default is 
STANDARD. Also see Section 3.3.2, SETUP. 

COPIES:<n> . [dptional] 


<n> number of copies to print. Default is one copy. 


EJECT:<:n= [optional] 
<n.- number of lines per page. Default is © if SPOOLED:DATA, 
62 otherwise. Specify 0 for no eject at all. 
PRIORITY {OVERNIGHT | LOW 
| STANDARD |HIGH} [optional] 
Print request priority. Default is STANDARD. 
The parameters FILE, PATH, FILESERVER, and SPOOLED are 


understood by the print server but are not relevant for normal 
use of spooled virtual print requests. 
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Note: "REQTYPE:PRINT" must be the first line of the header. 
Otherwise the keyword:value pairs can be arranged in arbitrary 
order. If the same keyword appears more than once, only the 
last occurrence is significant. Lowercase is acceptable for any 
keyword or value. 


Some implementations of the Print Server do not allow blanks 
immediately before or after the ":" in the header lines of the form 
"Keyword:value”. 


3.2.7 Escape Sequences 


The SETPRINT program allows you to specify and change all of 
the common header items. To change a header item not han- 
died by SETPRINT, such as TAG or DATE, you must send 
explicit instructions to the virtual printer using escape 
sequences. (The SETPRINT program is actually an editor for 
escape sequences and sends escape sequences to a virtual 
printer or file for you.) 


The virtual print driver normally accepts arbitrary characters 
from the local operating system, buffers them locally, and writes 
the buffers to the spooled print file. Escape sequences 
represent exceptions to this transparent processing. 


Escape sequences generally come from previously prepared 
text files or are written to the driver from within a program. 


A two-character trigger is used to signal the beginning of a vir- 
tual print escape sequence. The trigger characters must be sent 
in sequence to the driver through normal entry. The default 
value for the trigger is ESC V. but it can be changed as shown 
below. 


The following escape sequences can be embedded in the char- 
acter stream being directed to the virtual print driver. CR means 
carriage return.line feed. ESC V stands for the current escape 
sequence trigger, which is initially “ESC” (ASCII $1B) followed 
by "V" or "v” (ASCII $56 or $76). 
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If you want to include CRs as the first characters in the body of 
your text, use an optional CR (as indicated below by [CR)) in the 
escape sequences as indicated. 


V and all characters following ESC V can be upper or lower 
case. 


NOTE: Although spaces are used in the following paragraph for 
presentation clarity, no spaces should be used in escape 
sequences. 


Escape sequences sent to the printer become the default 
and will be used every time until changed. 


ESC V text CR 


Add ‘text’ followed by CR to the end of the header buffer as 
another header line. Only the header buffer is affected, not a 
print file currently open, for example: "ESC V priority:overnight 
CR". This escape sequence is distinguished from those that fol- 
low by the absence of a dot after the trigger. 


ESC V .C [CR] 
Close the virtual print file. If the buffer is not empty, it will be 
written out; the virtual volume will then be unmounted and 
renamed 

i SYSTEM/QUEUE/NEW/TIMESTAMP 
unless overwritten by ESC V .P (q.v). 
it is useful to have a small file called "EOF" (end of file) contain- 
ing ESC V .C, which can be used with the COPY command to 
produce listings as follows: 


COPY header filename+filename+ EOF LPT1 


Create the EOF file with DEBUG.COM or with an editor that will 
create a four byte file. Editors such as Wordstar will pad the 
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EOF file with zeros. Consequently, the zeros will reopen the vir- 
tual printer after the ESC V .C [CR] in the file closed it. 


The following will serve as a guide for your input if you use 
DEBUG: 


A.» DEBUG EOF 
—E100 
XXXX:0100 XX.1B XX.76 XX.2E XX.63 
—RCX 
CX XXXX 
74 
—W100 
Writing 0004 byte 
A> DIR EOF 
(Should be four bytes long) 


ESC V .R [CR] 


Reset the header buffer to the default size. The default size is 
the initial contents of the header unless it has been reset by 
ESC V .S or ESC V .N (q.v.). 


ESC V .N [CR] 


Reset the header buffer to be null. The default size (used by 
ESC V. R) is also set to zero. After this command the the 
default header can be completely respecified. Thus the virtual 
print driver can be used to create files other than print request 
files. 


ESC V .S [CR] 


Set the default size of the header (the point to which ESC V .R 
will reset the header) to be the current size of the header. The 
sequence to respecify completely the default header is ESC V 
.N [CR], ESC V headerline CR,....ESC V headerline CR. ESC V 
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.S [CR], after which more temporary header lines can be added 
and then removed with ESC V .R [CR]. 


This sequence is useful for setting different defaults (in, for 
example, a program run once when first booting the station). 


ESC V .P text CR 


Change the prefix of the pathname to be used for the virtual 
print volume to “text”. The specified prefix replaces the default 
“'SYSTEM/QUEUE/NEW/" used in conjunction with a times- 
tamp to create a request file. Open print files will be affected, for 
example: ESC V .P /inyoffice:system,queue/new/CR. This com- 
mand allows print requests to be created under directories to be 
sent by the PLAN Series File Transfer Server. In conjunction 
with ESC V .N this command allows other types of request files 
to be written. 


ESC V .Exx [CR] 


Change the escape sequence from ESC V to the two characters 


" Lá 


xx". 


3.2.7 Sending Escape Sequences to the Virtual Printer 


From the Keyboard or a File 


Escape sequences cannot be entered from the keyboard under 
IBM PC DOS since Escape is the line-cancel character in this 
system. 


Escape sequences can be entered from a file using the DOS 
COPY command. However EDLIN cannot be used to place 
escape sequences in a file since Escape is the line-cancel char- 
acter. Some other text editors or DEBUG or SETPRINT can be 
used to place escape sequences in a file. 


For example, the following escape sequences can be sent to the 
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virtual printer in a file called “header. txt”: 


ESC V priority:overnight CR 
ESC V .P /inyoffice;system/queue‘new CR 


Header.txt can precede a file to be printed called “filename1.txt”. 
To send the files header.txt and filename1.txt to the virtual 
printer, issue the following command: 


COPY header.txt + filename1.txt LPT1 


Close the virtual printer with <Alt> 222 or the escape sequence 
ESC V .C. 


The information contained in header.txt will appear on a header 
page which precedes the job to be printed. 


From an Application Program 


Each application program has its own rules for sending data to a 
printer. See the manual for your application program for this 
information. 


From_a Pascal Program 


The following program reconfigures the virtual printer using 
escape sequences. In this example the option “Eject:o'0”" is 
added to the header. 


PROGRAM SETPRN; 
CONST ESCAPE =27;{ASCII escape characters} 
VAR P:TEXT: 


BEGIN 
ASSIGN (P,"PRN’): 
REWRITE (P); 


WRITELN (P.CHR(ESCAPE),"V","EJECT:0"); 
END. 
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From a BASIC Program 


Since the network virtual spooled printer is a character device. it 
is opened and written to as though it were a local. real printer. 
This procedure is permitted with most languages under DOS. 
However limitations to BASIC (both Compiled BASIC and Disk 
and Advanced BASIC) exist on the IBM PC which make it 
necessary to open the virtual spooled printer as a sequential file 
instead of a character device. 


The following program sends “Testing: 1 2 3” to the spooled vir- 
tual printer. 


10 OPEN “LPT1" FOR OUTPUT AS #1 

20 PRINT #1, “Testing: 1 2 3" 

30 PRINT #1,CHR$(27);"V.C": REM closes virtual printer 
40 END 


Note: No colon follows the name of the virtual printer device in 
line 10 because LPT1 is opened as a file instead of as a device. 
The words "FOR OUTPUT” are necessary to ensure that files 
are opened sequentially, not randomly. 


Once the virtual spooled printer is opened as a sequential file, 
output from the BASIC program proceeds as if the printer were 
opened as a character device. 


To use both the spooled virtual printer and a local, real printer, 
run the NETCONFG program (described in Section 3.4.2). The 
program allows access to the local, real printer as character 
device LPT1:, and to the spooled virtual printer as file LPT3. 
The following is a program that uses both printers: 


5 REM assumes NETCONFG has been run 

10 OPEN "LPT1:" AS #1: REM opens real printer 

20 OPEN "LPT3" FOR OUTPUT AS #2: REM opens 
virtual printer 

30 PRINT #1,"This prints locally.” 


PRINTING 


40 PRINT #2,"This prints virtually.” 

50 PRINT #2,CHRS$(27);"V.C": REM closes virtual 
printer 

60 END 


Note: If a colon follows the device name in line 20, either a "Bad 
file number" or a “Device unavailable” error message will appear 
when the BASIC program runs. 


3.2.8 Automatically Closing the Virtual Printer 


The virtual printer is set up to close automatically after 15 
seconds. The length of time before the printer closes can be 
changed using NETCONFG. It can also be disabled, in which 
case the printer must be closed explicitly. 


3.2.9 Closing the Virtual Printer from the Keyboard 


As an alternative to the ESC V .C <Return- sequence or while 
waiting for the virtual printer to timeout, the virtual printer can be 
closed from the keyboard, regardless of ‘the program currently 
executing. 


The virtual printer driver looks at all keys read from the key- 
board to check for a special "close" key to close the virtual 
printer. To close the virtual printer, hold down the <Alt> key 
and type "222" on the numeric pad ONLY. Then release the 
<Alt> key. This returns an ASCII code of 222 decimal, $DE 
hexadecimal (a code which can be produced in no other way 
from the keyboard). 


Note: <ALT- 222 is only active on a printing device con- 
figured as LPT1 or PRN. 


The virtual printer driver intercepts this key and closes the pend- 
ing virtual print. This method of closing is especially useful with 
the <Shift><PrtSc:- (Print Screen) function to take a 
“snapshot” of the current screen. Type ~Shift»<PrtSc:-- and 
allow the cursor to scan the entire screen, then depress <:Alt>-, 
type 222 on the numeric pad, and release the -<Alt> key. 
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In response to the -Alt 222" entry, the virtua! printer will flush 
its buffer, unmount the temporary volume, move it to the Print 
Server's “new” queue, and mark the previous print closed. The 
next character buffered will re-open the virtual printer. If errors 
are encountered in the closing process, (if, for example, the 
MOVE command has failed), a beeping noise is produced, and 
the virtual printer is marked as closed. 


3.3 The Network Print Request Program (NPRINT) 


This section presents general information on the print request 
program and explains how to 


(1) print files from your workstation using NPRINT. 


(2) specify printing options. 
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3.3.1 Printing a File 


To print a file from the DOS environment using the request pro- 
gram instead of the virtual spooled network printer, execute 
NPRINT. NPRINT should be located on the shared library 
volume called 


iMAIN-LIB/IBMPC:DOS 


If the NPRINT program is not on the shared library volume. your 
print system software has not been installed. 


The following form will appear on the screen: 
Print Request Version X.X 
--> File(s) to print? 
FS Pathname: 
File server: $FE 
Page title: 
Identification: 


Number of Copies: 1 
Print Server: ANY 
Printer Model: LINEPRINTER 
Eject (O=none): 62 
Setup: STANDARD 
Priority (L'S/H/O): STANDARD 


As can be seen from this example, the print request program 
allows the user to specify more than just the file to be printed. 
Options such as number of copies, length of page, and job prior- 
ity can be selected by typing the <:Return’- key, which moves 
the arrow at the left of the menu from option to option. If the 
user accidentally hits the <Return.- key too many times and 
misses an option, he can still specify it: the arrow returns to the 
top of the print request when he types the < Return. > key for the 
“Priority” option. 
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Some of the option blanks may already be filled in when the 
print request form appears. These values, which appear when 
the print request form is first invoked, are called defaults. They 
may be set by the print system software, by you, or by the user. 
(Section 3.3.3 shows how to set the defaults.) 


Any value that appears next to an option can be replaced by 
locating the cursor key in that field (option blank) and typing in a 
new value. After typing in the value, strike the <Return> key 
and proceed to the next option. 


After having entered the values and issued the request, respond 
with a "Y" to the prompt that asks "Do you want to issue another 
request?” The request form appears again with the values just 
entered. Change only those values that must be different for the 
next request. If a previously specified pathname has a pass- 
word in it, that pathname will have to be reentered again. 


The values entered into the print request form are not retained 
after the print program is exited. 


3.3.2 Printing Options 


Here is a detailed explanation of the print options, the values 
that can be given for them, and the default state of the network 
print software if no option is specified: 


FILE NAME(S) 


Up to eight file names can be specified. Separate file names 
with commas. Files must reside on the same volume. When 
entering file names into the request form, enter them as they 
appear in the root directory for that virtual volume. 


The entire DOS pathname should be specified when printing a 
file in a subdirectory using NPRINT. For example, a program 
called EXT.PAS in a subdirectory called PROGRAMS would be 
specified as /PROGRAMS-EXT.PAS. 
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FS PATHNAME 


Enter the complete pathname of the virtual volume upon which 
the file(s) to be printed reside. 


if a network default directory is set, a partial pathname can be 
entered. For example, if s:MAIN/USERS is the default directory, 
you can enter 
TEST/EXAMPLE 
instead of 
iMAIN/USERS, TEST/EXAMPLE 
The following section tells how to set default pathnames so that 
they automatically appear in the print request form when it is 
invoked. 
Files to be printed can reside in virtual volumes that are pro- 
tected by passwords. This protection can prevent the files from 
being read (and printed) unless you provide the correct pass: 
words. 
if file server passwords have been set, enter them in the form 
iMAIN. USERS, TEST:password/EXAMPLE :password 
Press <<Return> to accept the pathname, and it will be 
redisplayed without the passwords. 


FILE SERVER 


Specify the name or address of the file server that manages the 
hard disk on which the files to be printed reside. 


(You must know the names and addresses of the file servers 
currently serviced by the Print Server $FE for example). 
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PAGE TITLE 


The title that typed in will be printed two lines down from the top 
of each page of the print job. The date, time, and page number 
are printed on the same line. The name of the file being printed 
(and its network volume) will appear on the next line. A blank 
line completes the 5-line header on each page. If the page title 
field is left blank, no page titles will be printed, and the job will 
begin at the top of the page. If a title is provided or the default 
is accepted, pages will be numbered. Otherwise page number- 
ing must be provided by the file being printed. 


Type <Space-<Return> to remove a default title and have no 
title printed. 


Text processing programs usually include their own title and 
page number values. When you wish to print files of formatted 
text, "PAGE TITLE” in the list of options should be left blank. If a 
default is displayed, remove it by entering <Space ><Return>. 


IDENTIFICATION 


The word or words typed on this line will appear as the job's 
identifying "I.D." as it waits in the print queue. You can enter a 
descriptive I.D. If the line is left blank, the system will fill in the 
field with “filename on volumename" (the name of the file you 
have specified to be printed and the volume upon which it 
resides). 


COPIES 


If you do not specify the number of copies, the print system will 
print one copy. Between 1 and 999 are allowed. If multiple files 
A, B, C have been specified, the copy sequence will be A, B, C. 
A B, C,... 


Pages will be numbered consecutively, and the page number 


will be reset only at the end of each copy, not at the end of each 
file. 
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PRINT SERVER 


Each printer in the Print Server subsystem is associated with 
three identifying tags: the name or address of its print server 
station, its own (printer) name, and the name of its setup(s). 
For a job to be printed on a specific printer, the name tags 
specified in the print request must match the name tags given 
you have given to the printer. 


The "PRINT SERVER" tag identifies the print server station that 
controls a particular printer (or printers). Enter "ANY" if you do 
not care which print server handles your request. To have a par 
ticular printer do your job, specify the printer's server station 
number in decimal or in hexadecimal (preceded by "$"), or enter 
the name of the print server station if it has been given one 


In some cases printers at more than one print server station are 
acceptable for completing a print job, but “ANY” of the print 
server stations are not acceptable. To specify more than one 
print server station, enter the addresses (addresses can be 
expressed in decimal or hexidecimal) separated by commas. 


PRINTER MODEL 


The "PRINTER MODEL" tag is the name given to a particular 
printer. This name can describe, for example, the type of printer 
(“DAISYWHEEL"), or its function (‘CHECKWRITER"), or its 
location ("2NDFLOOR"). Several printers can have the same 
name and be differentiated by their SERVER and SETUP tags. 


EJECT 


The Eject option controls page length. In the list of options 
above the default is 62; thus, after 62 lines have been printed 
on a page, the printer will eject the page and begin a new one. 
Entering the number © will cause the printer to print without 
ejecting. 
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Note that most output from text processing programs should be 
printed with EJECT=@. This does not mean that the text will be 
continuous: most text processing programs include page-eject 
commands for the printer. 


SETUP 


Each printer is identified by a SETUP tag. The print server uses 
SETUP to mean a combination of setup parameters required to 
use a particular form. Some forms used in your printer may 
require a different printer setup from the standard forms. Char- 
acter spacing, lines per inch, forms length, and ribbon can be 
different for special forms. 


in the print menu the default value for SETUP ıs “Standard” 
The kind of paper or forms which will be standard for each 
printer and the name of the setup should be chosen with your 
installation in mind. 


For example, if you wish to print material on colored paper, 
queue the print request using the word “COLOR” (or some other 
tag you have designated in the “SETUP” category. The job will 
not be printed until the print server station's current setup is 
"COLOR". You can change the current setup tag. The pro- 
cedure for changing setup tags at the server console is 
described in detail in the Print Server Installation and Operation 
Manual for your print server (see Bibliography). 


The value “ANY” is allowed for the SETUP tag. 


PRIORITY 


Print jobs are performed by the server software according to the 
priority assigned to them: “HIGH” priority jobs are printed first, 
"STANDARD" next, and "LOW" last Jobs with Overnight priority 
are put aside and printed in a special time period at night. The 
hours of the Overnight printing period can be set so as to be 
most convenient. 


3-28 


PRINTING 


Once a printer begins a job, it will continue it even if higher prior- 
ity jobs are subsequently queued behind it. For this reason very 
long jobs should be given Overnight priority rather than Low 
priority. 


Typing <Esc> at any time will cause Request to redisplay the 
menu as you have filled it in and to display the message 


[Type <Esc><Return> to abort.]------------ 
Issue print request (yes/no)? 


Typing "N" will return you to the list of options. The values you 
have entered are still displayed as defaults for your next job 


Typing "Y" will cause the files specified to be queued for print 
When you queue a print job, the print program will add your 
“print request" to the queue file on a disk served by you: default 
file server. This request will contain the names of the files you 
have asked to be printed as well as the number of copies and 
other information you have provided. 


The print server stations will read this request file. and the 
correct printer will print out the files you’ have asked for. The 
appendix for your operating system environment discusses how 
to check on the status of a print request and how to kill a 
request before it is printed. 
When your request is queued, a message such as 

FILE EXAMPLE ON .MAIN:DOE:A queued for print 

More files to print (yes.no)? 


will be displayed 


Typing "Y" will cause the list of options to be redisplayed with 
the values used for the previous request retained as defaults. 


Typing “N” will return you to the original print request function 


menu or to your operating system command line. Please note 
that what happens here is dependent on your particular 
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operating system environment and is explained in the appropri- 
ate appendix. 


NOTE: To queue a request for you, the program requires a free 
virtual drive at your workstation. If you have virtual volumes 
mounted on all drives, the program will ask you for the number 
of a drive it can unmount (Dn) or wil! unmount a drive without 
asking (and will not remount your volume later), depending upon 
your workstation environment. 


3.3.3 Presetting Defaults for the Print Request Form 


When you invoke your print request form, you will note that 
there are several blanks for you to use to specify printing 
options. You may decide that many of the option specifications 
need not change from printing to printing. For instance every- 
thing one user prints may be from a certain volume, or he may 
always use a certain printer and setup combination, or he may 
always want two copies of everything. 


If users would prefer not to specify each of the options every 
time they print a file, you can preset defaults for them. 


There are two files called DEFAULTS: one, located on the 
shared library volume, you will configure; the other may be con- 
figured by the user and is to be located on the current default 
drive. 


The DEFAULTS file on the current default drive can be set by 
the user to specify defaults for the printing options. The defaults 
specified in this file will be read into the print request form each 
time it is invoked. 


When the NPRINT program is executed, the option specifica- 
tions from the DEFAULTS file on the current default drive are 
read into the appropriate option blanks. If the DEFAULTS file 
does not contain specifications for all possible option blanks, the 
DEFAULTS file on the shared library volume will be read in to fill 
the blanks. The DEFAULTS file on the shared library volume is 
used by you, as system manager. to set default specifications 
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that are expected to be true for most users most of the time. 
The users DEFAULTS file takes precedence over the shared 
library DEFAULTS file. This means that if both files specify a 
default for the same option, the user's specification is the one 
that is used. 


Having the default values automatically placed in the form saves 
time. However, if one or more of these preset defaults is not 
right for a particular job, it can be changed in the print request 
form. Use the cursor keys or the <Return=> key to move the 
cursor to that line and type the new value. The previous con- 
tents lose their highlighting as soon as the first character is 
entered. To recover the previous contents, press the right arrow 
cursor key. When you have finished filling in or approving all of 
the option specifications, follow the instructions at the bottom of 
the screen. You will then be prompted to issue your request 


In order to preset defaults for print request options, use an edr 
tor to create a text file called DEFAULTS. 


The following list shows the possible options for which you can 
set defaults and the proper syntax to use. If you do not wish to 
set a value, the DEFAULTS file on the shared library volume 
may contain a value for that default, or you can fill in its value 
each time you initiate a print request. 
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To Set Enter in DEFAULTS.TEXT 

User User: User ID 

Name Name: User Name 

Network Pathname Print: Pathhame <Pathname> 

File Server Print: FS - Station name or address> 
Page Title Print Title < "Title"> 

Identification Print Identification <"Identification” > 
Print Server Print. Server - ‘stn name or address> 
Print Model Print: Printer ~~ printer name> 

Eject Value Print: Eject <vaiue> 

Setup Print: Setup <name> 

Priority Print: Priority <Priority Value > 
Copies Print: Copies <number> 

Below is an extended explanation of each of the parameters in 


the | 


ist given. You can learn the purpose of each parameter and 


decide what your default, if any, should be 


(1) 
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"User" and "Name" are not restricted to the print request 
program. They must be entered by beginning lines with 
"User:" and "Name:". The print request program will ignore 
any lines in DEFAULTS that do not begin with “Print:”, 
"User:", or "Name:" since other Nestar software products 
also use DEFAULTS to preset defaults. “User” may be 
printed out as a logo on the header page of your job (if the 
header pages have been formatted to do so) and is usually 
a short ID, such as your initials. “Name” may also be 
printed out on the header page and is usually a longer iden- 
tification, such as your full name. 


Network Pathname is the full pathname or, if a default 
directory is set, a partial pathname. For example if 
/MAIN, USERS is set as the default directory, 

SMITH.A 


can be specified in DEFAULTS and the Request program 
will understand that 


iMAIN/USERS/SMITH:A 


PRINTING 


is meant. 


(3) File Server is the station address in decimal, or in hexade- 
cimal preceded by "$” Users should know their file server 
name if one has been assigned. 


(4) Page Title and Identification options must be enclosed in 
quotes. For no title, include in DEFAULTS 


Print: Title’” 
(5) Copies must be between 1 and 999. 


(6) Print Server is the station address in decimal or in hexade l 
cimal preceded by "$". Assign the print server a name 'f 
necessary. 


(7) Eject (page length) must be between 0 and 999. 


(8) Priority must be L, S, H, or O (Low, Standard, High, or 
Overnight). 


Multiple commands can be entered on the same line. 
Below is a sample DEFAULTS file: 


User: Smith 

Name: John Smith's Fiscal Account 

Print: Pathname :MAIN/USERS/SMITH/ TEXT 
Print: FS $FD 

Print: Copies 3 Eject 55 

Print: Server FISCAL 

Print: Printer Lineprinter Priority Low 

Print: Forms Ledger 

Print: Title “Smith's Accounts" 


If the DEFAULTS file above were placed on the current default 


drive, its contents would be read by the Request program when 
it is invoked and the following form would appear: 
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Print Request Version X.X 
--» File(s) to print? 
FS Pathname: MAIN;/USERS, SMITH. TEXT 
File server: SFD 
Page title: Smith's Accounts 
Identification: 


Number of Copies: 3 
Print Server: FISCAL 
Printer Model: LINEPRINTER 
Eject (O=none): 55 
Setup: LEDGER 
Priority (L‘S/H.O): LOW 


As we explained above, the Request program will also read the 
DEFAULTS that is located on the shared library volume. This 
file contains the defaults set for the whole installation. Any 
defaults set in your own DEFAULTS, however, will take pre- 
cedence over the shared DEFAULTS file. Any default values 
missing from your file will be supplied, if present, from the 
shared file. 


When your job is printed, a “header” page is printed in front of it, 
listing information specified in the DEFAULTS. This information 
may include a logo representing your “user” value, the name of 
the file printed, its FS pathname, and other such information. 


3.3.4 Multiple File Servers 


A print request is stored as a virtual volume on the hard disk 
served by your default file server. This small virtual volume is 
placed under a special directory created for new request 
volumes. 


This request will be read by the print server stations, and the 


correct server will cause the files to be printed. This print server 
will check to see which file server is specified in the options list 
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and will search on that file server's disks (and on no others) for 
the file to be printed. 


You can enter the station address of any file server station on 
your network. 


3.4 Local Printers 
3.4.1 Before Using Your Local Printer 


Before using your local printer, make sure that the proper printer 
interface card is installed in your IBM PC computer. The 
appropriate printer driver code must be installed on your boot 
disk. 


You must also reconfigure your network driver. As distributed, 
the network driver includes a virtual printer device named LPT1 
(alias PRN). The names LPT1 and PRN are normally used by 
non-networked DOS to refer to local printers. Therefore local 
printers are not accessible with the driver as shipped 


The virtual printer device can be renamed VPRN (alias VPRN2) 
with the NETCONFG program (discussed in Section 3.4.2) 
With this change the names LPT1 and PRN refer to the local 


printer (if present), and both local and virtual printer devices will 
be accessible. 


Note: The <Shift>-<PrntSc> and <Ctrl><<PrtSc - keys always 
print on LPT1 (whether local or virtual). 
3.4.2 Using NETCONFG to Rename the Virtual Printer 


Device 


NETCONFG.EXE is distributed on :MAIN.LIB/IBMPC,DOS. To 
access the NETCONFG program, type 


C: NETCONFG 


assuming that your library volume is mounted on drive C:. 
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You will be presented with a menu that allows you to update 
various parameters. The parameter you are concerned with is 


DEVICE NAME OF VIRTUAL PRINTER (DEFAULT LPT1) 
Type in 

VPRN 
(alias VPRN2). 
NETCONFG can also toggle VPRN (and VPRN2) back to LPT1 
(and PRN). Use the same steps outlined above except type in 
"LPT1". 
3.4.3 Using NETCONFG to Disable ~ Alt> 222 
Some communication programs will not work because of the 
checks made for < Alt> 222 by the virtual printer. NETCONFG 
can be used to cause the virtual printer not to check for 


<Alt>222. The parameter involved is 


DISABLE <Alt> 222 CHECK (default enable) 


3.4.4 Using Both Local and Virtual Printers 

lf your network contains a virtual printer and a local printer, you 

will need to reconfigure your network driver using NETCONFG 

to access both printers. See Section 3.4.2 

To get a printout from your local printer, use the command 
COPY filename LPT1 (or PRN) 

To get a printout from your virtual printer, use the command 


COPY filename VPRN (or VPRN2 or LPT3) 


See Figure 3-3. 
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It is possible to use your virtual printer and your local printer 
simultaneously. Simply issue the same commands discussed 
above, one after the other (in no particular order). For example, 
you have two files to be printed, EXAMPLE1.TXT on your local 
printer, and EXAMPLE2.TXT on the virtual printer. First issue 
the command 


COPY EXAMPLE1.TXT LPT1 
to your local printer. Then issue the command 
COPY EXAMPLE2.TXT VPRN 


to the virtual printer. 
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Figure 3-3 


Local and Virtual Printers 
(After Using NETCONFG) 


LOCAL PRINTER 








copy filename 


WORKSTATION (LPT1 (or PRN) 


t — p G 


copy filename VPRN 
(or VPRN2 or LPT3) 


VIRTUAL SPOOLED 
NETWORK PRINTER 
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3.4.5 Using A Local Printer Only 


To use a local printer only, you will need to reconfigure your net: 
work driver using NETCONFG. See Section 3.4.2. 


To get a printout, use the command 
COPY filename LPT1 (or PRN) 
See Figure 3-4. 
If NETCONFG is not used to reconfigure the driver, output to 


LPT1 will be spooled. If no print server is present in your net- 
work, the output will never be printed. 


Figure 3-4 


Local Printer Only 


WORKSTATION 







copy filename 
LPT1 (or PRN) 


LOCAL 
PRINTER 
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3.5 Tracking Print Requests With PRINTQ 


Track your print requests with PRINTQ, a program run at an 
IBM PC DOS workstation that displays queue information. 


To run PRINTQ simply access the Utilities Menu from the Nes- 
tar Main Menu. Then select the PRINTQ option. 


The PRINTQ screen consists of two sections, left and right 
The right screen displays master queue information including 


(1) the date and time your print request was queued 
(2) the file server your print request was queued on 
(3) the queue number your request was issued 
( 


4) the user ID or station address that your request was 
queued under 


(5) the status of you print request (waiting, or active, or com- 
pleted) 


The left screen presents the following options: 


(1) Update queue display. 

(2) Suspend queue display. 

(3) Examine highlighted request with option to alter or cancel. 
(4) Display requests of one user. 

(5) Display print server status. 

(6) System management. 


The master queue information displayed on the right screen is 
updated every minute. However the queue can be updated 
immediately by selecting the "Update Queue Display” option on 
the left screen. 


To suspend the queue display, select the appropriate option 
from the left screen. The’Suspend Queue Display” option will 
then change to the “Periodically Update Display” option which 
should be pressed when you want the display to be updated 
every minute again. 
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The default displays the requests of ALL users. To display the 
requests of a particular user (CMS, for example), select the 
appropriate option. You will be prompted, "Display request of 
what user?” Supply either user ID (initials or name) or station 
address in hexadecimal. In this case, enter the initials "CMS". 


A list of requests queued by CMS will be displayed on the right 
screen. PRINTQ will only display maximum one screenful of 
past requests. Press <Esc> when you are ready to return to 
the previous menu. 
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Chapter 4 


Programming 


4.0 Introduction: Using the Network from Programs 


Nestar provides library routines that allow programs to access 
network facilities. There are two different kinds of routines: 


(1) routines to send commands to a file server and receive the 
file server response(s). (Sections 4.1 through 4.5) 


(2) routines to send and receive messages to/from other (non- 
file server) stations. (Section 4.6) 


The file server command routine is called FSCMD (and in some 
languages, FSRSP). FSCMD is used to send an ASCII string 
(like “SHOW MOUNTS’) to a file server. FSCMD or FSRSP is 
used to receive the responses. 


The routines used to send messages between user stations are 
NET_OPEN, NET_CLOSE, NET_SEND, and NET_RECV. 
NET_OPEN and NET_CLOSE are used to start and end a ses- 
sion within which messages may be exchanged between sta- 
tions using NET_SEND and NET_RECV. Messages are not lim- 
ited to ASCII strings. They may be arbitrary-length data in 
memory. 


These routines are kept in a separate library for each language 
and compiler supported by Nestar. These are arranged on DOS 
subdirectories on the DOS library. The directory names describe 
the language, compiler, and version with which the units are 
designed to be compatible. 


The first directory level describes the language with which the 
library is meant to be used, the second level refers to the com- 
piler, and the last level refers to the version of that compiler. 
Languages supported include C, Pascal, COBOL, BASIC, and 
Assembly languages. The IBM version of each language is 
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supported, except for C, for which IBM does not supply a com- 
piler. For C the Microsoft Lattice Compiler is supported. 


For example, there are two versions of the IBM Pascal Compiler 
supported on the network. The library for these are stored on 
the following two subdirectories: 


PASCAL IBM, 1.00 
and 
.PASCAL IBM,2.00 


Libraries for other languages are arranged using the same 
scheme. 


Nestar also provides the BRUN command (described in Chapter 
5 of the PLAN Series Network Command Reference Manual) 
on the network device driver. BRUN allows a program to be 
downloaded from a binary volume on a file server to a worksta- 
tion and then executed. For details see Section 4.7. 


The following sections discuss specifics of the available support 
for various languages. Not all facilities are provided for all 
languages. 


4.1 Using File Server Commands from a Pascal Program 
The compilers currently supported are: 


IBM Pascal Version 1.00 
IBM Pascal Version 2.00 
Microsoft Pascal Version 3.20 


The shared library contains object files containing “units” that 
allow the user to write Pascal programs that issue commands to 
the file server. 
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The units are: 
CMDUNIT 


a Pascal unit that allows programs to issue file server or local 
commands (that is, any command accepted by the NET utility 
program). In fact this is the unit that the NET utility program 
uses. CMDUNIT also includes the INIT command. This unit's 
object file is in NETPAS.LIB; its interface file is CMDUNIT.ITF. 


NETUNIT 


a Pascal unit that allows programs to issue commands to the 
file server (local commands are NOT accepted here) and option- 
ally gets responses back for processing by the program. This 
units object file is in NETPAS.LIB; its interface file is 
NETUNIT.ITF. 


For convenience all needed object files have been collected in 
the library file NETPAS.LIB, which you can specify at link time. 
The order of linking libraries is NETPAS.LIB, then PASCAL.LIB. 
4.1.1 CMDUNIT 
If the user wants to execute file server or commands which also 
require local processing (like INIT or SHOW DRIVES), the Pas- 
cal procedure CMD or CMDLOOP in CMDUNIT should be used. 
The CMD procedure has the form: 

CMD (COMMAND, OPTIONS) 
where: 


COMMAND 


is a string variable whose value is the file server command or 
local command to be executed. 
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OPTIONS 
iS an integer variable which must be set to: 


‘(0 — dont echo command if error. 
1 — do echo command if error. 


Examples: 
CMD("“show mounts",0); 
CMD("show drives”,0); 
CMD(“mount /MAIN,A,D1; MOUNT /MAIN:B,D2”,1); 


For programs in which the user enters file server or local com- 
mands from the keyboard until the user types QUIT or 
<escape>, the CMDLOOP procedure is provided. It has the 
form: 


CMDLOOP (PROMPT); 
where: 
PROMPT 


is the string variable whose value is the prompt to be issued to 
the user. 


Examples: 


CMDLOOP(’:’): 
CMDLOOP("FS command or QUIT:”); 


The following program, COMMAND, demonstrates the use of 


CMDLOOP to execute file server commands. This is, in fact, a 
subset of the source listing of the NET utility program: 
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(“SINCLUDE “CMDUNIT ITF") 
PROGRAM COMMAND; 

USES CMDUNIT; 

BEGIN 


CMDLOOP(":”) 
END. 


4.1.2 NETUNIT 
To execute a file server command and get the return code back 
for evaluation by the program, use the FSCMD procedure. The 
procedure has the form: 

RC := FSCMD (STATION, COMMAND, RESPONSE); 
where: 
RC 
is an integer representing the “return code” sent back by the file 
server (see Appendix A for a list of return codes and their mean- 
ings). A return code of 0 means no errors. 
STATION 
is the station number of the file server to which the command is 
directed. If STATION is zero, the current default file server is 
used. 


COMMAND 


is a string variable whose value is the file server command to be 
executed. 
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RESPONSE 


is a string "VAR" variable whose value is set to the last 
response line sent back by the file server. If the command has 
been executed successfully, then the last response is usually 
"OK". Otherwise the last response contains the error message 
text. 


All intermediate response lines are written to the screen. 
To execute a file server command and get all the responses 
back for evaluation (including those usually displayed on the 


screen without program intervention), use the FSCMD1 pro- 
cedure. The procedure has the form: 


RC := FSCMD1 (STATION,COMMAND,RESPONSE, 
NEWCMDFLAG DONEFLAG); 
where: 
RC 
is an integer representing the "return code” sent back by the file 
server. 
STATION 
is the station number of the file server to which the command is 


directed. If STATION is zero, the current default file server is 
used. 


COMMAND 
is a string variable whose value is the file server command to be 


executed when NEWCMDFLAG is set to TRUE. When 
NEWCMDEFLAG is set to false it is ignored. 
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RESPONSE 


is a string “VAR” variable whose value is set to the next (or first) 
response line sent back by the file server. 


NEWCMDFLAG 


is a boolean variable whose value is TRUE when a command is 
initially sent to the file server. It is FALSE on successive calls 
which get the next response lines. 


DONEFLAG 


is a boolean "VAR" variable. Its initial value is ignored and it is 
set to TRUE if this is the last response line and FALSE if there 
are more response lines. 


For example, a program fragment might contain: 


CMD := “file server command"; 

RC := FSCMD1 (0,CMD,RSP, TRUE,DONE); 

WHILE NOT DONE DO BEGIN 

...process RSP (RC not valid until DONE = TRUE) 
RC := FSCMD1(0,CMD,RSP,FALSE,DONE); 

END; 

...process final RSP and RC 


If you write an application in PASCAL that uses NETUNIT to 
mount volumes and also uses files, you should observe the fol- 
lowing restriction: Do not mount onto a drive that already has 
files open on it. If you do not observe this restriction, DOS will 
not close the files on the original diskette or virtual volumes, and 
you may lose data on the previously mounted and new mounted 
volumes. 
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A Sample Program 


The following program, FSCMDPAS.PAS, demonstrates the use 
of FSCMD to send commands to the file server with a Pascal 
program. The FSCMDPAS program will get an input line from 
the user and send it to the file server for execution. 


FSCMDPAS differs from NET in the following ways. 


(1) Both the code number and reply returned by the file server 
are displayed on the console. 


(2) The commands referring to the user's own drives (SHOW 
DRIVES, SET drive) are not available in FSCMDPAS. 
They are implemented in the NET program by CMDUNIT, 
not by the file server. 


(“S$INCLUDE: "NETUNIT.ITF™) 
PROGRAM FSCMDPAS (INPUT,OUTPUT); 
USES NETUNIT; 
VAR 
RC: INTEGER; 
CMD: NETLONGSTR; 
REPLY: NETSTR80; 
BEGIN 
WRITELN ("File Server Command Program in Pascal"); 
REPEAT 
WRITE ("FS COMMAND ?"); 
READLN (CMD); 
IF CMD.LEN «> @ THEN BEGIN 
(© Send command to default file server *) 
RC := FSCMD (@.CMD,REPLY); 
WRITELN (RC:0,",", REPLY) 
END 
UNTIL CMD.LEN - 0; 
(© All done if nothing typed `) 
WRITELN ("Ciao.”) 
END. 
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A Sample execution of the FSCMDPAS program : 


File Server Command Program in Pascal 
FS COMMAND? show date 

DATE IS 03/02/84 

0,0K 

FS COMMAND? foo 

1, ILLEGAL COMMAND 

FS COMMAND? 

Ciao. 


This program (in a file called FSCMDPAS.PAS) is compiled 
(using IBM Pascal Version 1.00) and linked as follows: 


PAS1 FSCMDPAS; 
PAS2 
LINK FSCMDPAS,,,NETPAS+PASCAL; 


lf you write an application that uses FSCMD to mount volumes 
and also uses files, do not mount onto a drive that already 
has files open on it. If you do, DOS will not close the files on 
the original diskette or virtual volumes, and you may lose data 
on the previously mounted and newly mounted volumes 


4.2 Using File Server Commands from a COBOL Program 
The compiler currently supports IBM COBOL Version 1.00. 


File server commands can be issued from a COBOL program by 
linking with a library called NETCOB.LIB. This library provides 
two routines, FSCMD and FSRSP, which can be called from a 
COBOL program using the “CALL” statement. The following 
program (FSCMDCOB.COB) demonstrates the use of these 
routines: 
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000001 IDENTIFICATION DIVISION. 
000010 PROGRAM-ID. FSCMDCOB. 
000020 ENVIRONMENT DIVISION. 
000040 

000050 DATA DIVISION. 

000095 

000100 WORKING-STORAGE SECTION. 
000110 .01 COMMAND 


000120 02 CMD1 PIC X. 
000130 02 FILLER PIC X(127). 
000140 

000150 01 RESPONSE. 

000160 02 RSP1 PIC X. 
000165 02 RSP2 PIC X(79). 
000170 02 FILLER PIC X(48). 
000180 

000219 PROCEDURE DIVISION. 
000220 


000222 BEGIN. 

000225 DISPLAY "File Server Command Program in COBOL". 
000226 DISPLAY "". 

000227 

000230 CMD-LOOP. 

000235 MOVE "" TO RSP1. 

000240 DISPLAY (24, 1)": ". 

000250 ACCEPT (24, 3) COMMAND. 

000260 = IF CMD1 NOT= "Q" AND CMD1 NOT = “q" 
000270 CALL “FSCMD” USING COMMAND 
000280 ELSE 

000290 GO TO EXIT-PGM. 

000300 PERFORM GET-RSP UNTIL RSP1 = "=". 
000305 DISPLAY "”. 

000310 GO TO CMD-LOOP. 

000320 

000330 GET-RSP. 

000340 CALL "FSRSP" USING RESPONSE. 
000345 DISPLAY". 

000350 DISPLAY (24, 1) RSP2. 

000360 

000370 EXIT-PGM. 

000380 STOP RUN. 
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This example prompts you for commands until "Q" or "q" is 
entered. Each command is sent to the file server for processing 
by calling “FSCMD”, using COMMAND as the parameter. Note 
that COMMAND is defined as a string of 128 characters padded 
with spaces on the right. 


Next response lines are received from the file server one at a 
time by calling "FSRSP", using RESPONSE as the parameter. 
RESPONSE is also defined as a string of 128 characters. The 
first character is a space if the line is an intermediate line. The 
last response line has a plus sign as the first character. The first 
character is not displayed but is used to determine if "FSRSP" 
should be called again. 


In this example each line is processed as it is received. No 
time-consuming operations can be performed between these 
response lines. Such operations are not tolerated by the com- 
munications protocols. 


If operations are to be performed on response lines, save the 
responses in memory as they arrive. After the final response 
has been received, line-by-line processing can be performed 
against the buffered data. 


The above program (in a file called FSCMDCOB.COB) is com- 
piled and linked as follows (assuming the COBOL compiler is on 
drive C): 


C:COBOL FSCMDCOB,,,/CC; 
C:LINK FSCMDCOB,,,NETCOB+C:; 


Note that the COBOL network command routines do not support 
the following local commands: 


SHOW DRIVES (use ?d instead) 
SHOW FS (use ?@ instead) 

SET FS (use (a@nnn or «@$nn instead) 
INIT 
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4.3 Using File Server Commands from a Compiled 
BASIC Program 


The BASIC compiler supported is IBM BASIC Compiler, Version 
1.00. 


Network commands can be issued from a compiled BASIC pro- 
gram by linking with a library called NETBAS.LIB. This library 
provides two routines, FSCMD and FSRSP, which can issue 
network commands and receive response lines. Below is a 
sample program that shows how to use these routines: 


10 print "File Server Command Program in Compiled BASIC” 
20 line input ": "; cmd$ 

30 if cmd$="q" then stop 

40 call fscmd(cmd$) 

50 rsp$=space$(80) 

60 call fsrsp(rsp$, rlen%) 

70 rsp$=left$(rsp$, rlen%) > 

80 print rsp$ 

90 if left$(rsp$,1)="+" then 20 else 50 


Line 10 prints a greeting. Line 20 prompts the user for a com- 
mand. If the command is "q", the program terminates; other- 
wise line 40 sends the command to the file server. Line 50 is 
needed because FSRSP will only fill an existing string, not 
expand it. Therefore, rsp$ is filled with eighty spaces. Line 60 
reads a response line from the file server and also returns the 
length of the response in rlen%. Note that the second parame- 
ter to FSRSP must be an integer variable: its name must end in 


"og" 


Line 70 trims the response string back to the length actually 
used. Line 80 prints the response line. Line 90 decides whether 
the response line was the last line or not. Intermediate lines 
have a space or a minus sign inserted by FSRSP, response 
lines--when using the secondary file server--may have a minus 
sign inserted, while the last response line has a plus sign added 
at the front. 
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The above program (in a file called FSCMDBAS.BAS) is com- 
piled and linked as follows: 


BASCOM FSCMDBAS ;N;0; 
LINK FSCMDBAS,,,NETBAS+BASCOM; 


Note that the BASIC network command routines do not support 
the following local commands: 


SHOW DRIVES (use ?d instead) 
SHOW FS (use ?@ instead) 
SET FS (use @nnn instead) 
INIT 


4.3.1 Error Processing from Compiled BASIC Programs 


BASIC allows disk errors to be handled by your BASIC program. 
if an error occurs while performing disk I/O on the network, the 
BASIC error variable ERR is set to one of the values 70, 71, or 
72. Error 70 is “Disk Write Protect” and indicates that you tried 
to write on a drive that was mounted read-only. Error 71 is "Disk 
Not Ready” and indicates that the file server did not respond to 
a read or write request within the timeout period. This operation 
can be retried. Error 72 is "Disk Media Error” and indicates that 
some other error ocurred. To get more information on the exact 
error, you must interrogate the network disk driver, using the 
"2d" command (see Section 2.6.5, PE= and SE= for more 
information.) Some of these errors are retriable by your applica- 
tion program. 


To allow retrying some disk errors, the following process is 
recommended. An error exit is set up using the BASIC ON 
ERROR GOTO statement. This error exit determines the cause 
of the error and whether it can be retried. The error exit returns 
with a RESUME statement to the point in the program where 
the error occurred. All BASIC statements that might cause net- 
work I/O should check an error status variable to see if an error 
has ocurred, and if so, whether the error may be retried. (The 
error exit cannot retry the operation itself because there is no 
recovery from errors which happen within the error exit.) 
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4.4 Using File Server Commands Within a C Program 


The compilers currently supported are Microsoft C Version 1.04, 
Microsoft C Version 3.00 and IBM C Version 1.00. The small, 
medium and large models are supported for Microsoft C Version 
3.00 and IBM C Version 1.00. 


The DOS 3.10 shared library volume contains a library 
(NETC.LIB) that allows the C user to write programs that issue 
commands to the file server. 


To execute a file server command and get the return code back 
for evaluation by the C program, use the FSCMD function. 
FSCMD is contained in NETC.LIB. Specify NETC.LIB when link- 
ing. The function has the following form: 


int FSCMD (STATION, CMD, RSP, NEWCMD, DONE); 
char STATION, “CMD. *RSP; 
int NEWCMD, ‘DONE; 


where: 

FSCMD 

(the function result) is an integer representing the “return code” 
sent back by the file server (see Appendix A for a list of return 
codes and their meanings). A return code of @ means no errors. 
STATION 

is the station number of the file server to which the command is 
directed. If STATION is zero, the current default file server is 
used. 

CMD 

is a string variable containing the file server command to be 


executed. Note that the address of CMD is passed as a param- 
eter to FSCMD. 
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RSP 


is a string variable that will contain the last response line sent 
back by the file server. If the command has been executed suc- 
cessfully, then the last response is usually "OK". Otherwise the 
last response contains the error message text. Note that the 
address of RSP is passed. 


NEWCMD 


is a boolean value. It is TRUE when a command is initially sent 
to the file server. It is FALSE on successive calls which get the 
the next response lines. 


DONE 


is a boolean variable. Its initial value is ignored, and it is set to 
TRUE if the last response line has been received and FALSE if 
there are more response lines. Note that the address of DONE 
is passed. : 


For example, a program fragment might contain: 


cmd = “command”; 

rcode = fscmd (0, &cmd, &rsp, TRUE, &done); 
while (! done) { 

process RSP; (rcode not set until DONE is TRUE) 
rcode = fscmd (0, 0, &rsp, FALSE, &done); 

i 


process final RSP from FS if desired; 


A Sampie Program 


The following program, FSCMDC, demonstrates the use of 
FSCMD to send commands to the file server within a C pro- 
gram. The FSCMDC program will get an input line from the user 
and send it to the file server for execution. 
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FSCMDC differs from NET in the following ways: 


(1) Both the code number and reply returned by the file server 
are displayed on the console. 


(2) The local commands (SHOW FS, SET FS, SHOW 
DRIVES, and INIT) are not available in FSCMDC. 


main() 
{ 
int rc, done; 
char cmd[80], reply[80]; 


cprintf (“File Server Command Program in C”); 
putch (13): 
do { 
cprintf ("FS COMMAND? "); / prompt *: 
gets (cmd): /* read command from stdin */ 
if (strlen(cmd) > 0) { /* if a command 
was entered send command to default 
file server *; 
rc = fscmd (0, cmd, reply, 1, &done); 
while (!done) { :* print intermediate 
response lines *, 
cprintf ("%s", reply); 
putch (13); 
rc = fscmd (0, 0, reply, 0, &done); 
\ 
í 
‘print final response line *, 
cprintf ("%d,%s”", rc, reply); 
putch (13); 


l 
f 


else { 
“if no command then exit * 
cprintf (“Thank you, and Good night’): 
putch (13); 
exit (0); 


while (1 :* forever */); 
l 
f 
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A sample execution of the FSCMDC program: 


File Server Command Program in C 
FS COMMAND? show date 

DATE IS 03/05/84 

0,OK 

FS COMMAND? foo 

1,ILLEGAL COMMAND 

FS COMMAND? 

Thank you, and Good night 


The above program (in a file called FSCMD.C) is compiled using 
Microsoft C Version 1.04 and linked as follows: 


MC1 FSCMDC 
MC2 FSCMDC 
LINK C+FSCMDC,FSCMDC,,NETC+MC 


Note that the BASIC network command routines do not support 
the following local commands: 


SHOW DRIVES (use ?d instead) 
SHOW FS (use ?(@ instead) 
SET FS (use (nnn instead) 
INIT 


4.5 Using File Server Commands from Other Languages 


Programming languages that can open a DOS file for reading or 
writing MAY be able to issue file server commands. Language 
runtime systems usually interface with disk files, often wait to 
receive a complete sector of data before transmitting, fill an 
unfilled sector with blanks, or otherwise operate in a way incom- 
patible with the NCMD command channel. 


Nestar is committed to providing access to the command chan- 
nel from all IBM supported language products. In addition to 
Pascal, COBOL, compiled BASIC, and C (all described above), 
IBM interpretive BASIC and assembler have been interfaced to 
the NCMD device. Please contact Nestar technical support staff 
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with specific problems. 


4.6 The Network Send and Receive Support Code 


Nestar supplies modules that allow messages to be sent 
between user stations. These modules are available for Pascal, 
compiled BASIC, COBOL, C, and Assembler. For Pascal, 
BASIC, COBOL, and C, sample programs are provided on the 
DOS library volume. These programs show how to invoke the 
routines from these languages. The sample programs are in 
files called TNSRxxx.xxx where xxx is the extension appropriate 
to the language ("PAS", "BAS", "COB", or "C"). 


The interface to these routines is similar in all of these 
languages. We will discuss the entry points and their parame- 
ters in general before giving specifics for each language. 


There are four entry points- or subroutines for each of the sup- 
ported languages: NET_OPEN, NET_CLOSE, NET_SEND, and 
NET_RECV (in some languages these names are shortened). 
When in use, NET_OPEN is called once at the start of a pro- 
gram, and NET_CLOSE is called at the end. While the program 
is running, NET_SEND and/or NET_RECV are called in the 
order meaningful for your application. All four entry points return 
a result status to indicate success or failure. The return codes 
are summarized below. 


These two result codes are normally returned by the N.S.R. 
routines: 


Name Value 
NSR_OK 0 


Function completed successfully, for NSR_RECV this indicates 
that a message has been received. 


NSR_NM 1 
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No Message, NSR_RECV returns this if no message has been 
received. 

These four result codes indicate common errors: 

Name Value 

NSR_NOT_OPEN 2 

NET_OPEN must be called once before other entries can be 
called. 

NSR_SF 3 

The send has failed; the receiving station did not acknowledge 
the message. 

NSR_RF 4 


The receive has failed: an incomplete message was received. 


NSR_OVF 5 

The receive has failed; the message that came in was too large 
for the given buffer. 

These four return codes are unusual errors. If you can not dis- 
cover their cause, contact Nestar’s Technical Support Group: 
Name Value 


NSR_NO_NET 6 


The network interface card can not be found. 
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NSR_LSTN 7 


The "listen" table in the lower level network routines is full. 


NSR_RB 8 


A low level network “request block” could not be allocated. 


NSR_IGNR 9 

The “ignore” call to the lower level network routines failed. 

The four entry points and their parameters are discussed below. 
Each entry point is "non-blocking": the amount of time spent in 
each routine is either very short or can be controlled by the 
caller so that a program can do other tasks while sending and 
receiving messages. 

NET_OPEN A~ 
Input parameters: keep_time in seconds 

Returned results: status as discussed above 

NET_OPEN is called once at the start of a program using NSR. 
It tells the lower levels of network code to keep packets coming 
from NET_SEND which have been sent by other stations. These 
packets are kept until NET_RECV is called or “keep_time” has 
been exceeded. NET_OPEN will return "nsr_ok” normally. 
NET_CLOSE 

Input parameters: none 


Returned results: status as discussed above 


NET_CLOSE is called once at the end of a program using NSR. 
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It undoes the work of NET_OPEN. This is important: the pack- 
ets kept because of NET_OPEN will slow down other uses of 
the network from your station unless they are discarded or con- 
sumed. 


NET_SEND 
Input parameters: 


wait : how long to wait for receiver to acknowledge 
in seconds 
his_id : the six byte “host id" style address of the 
destination 
his_arc : the one byte station address, optional 
mess : the message to send 
length : the length of the message in bytes 
mess_type : the type of message, an arbitrary number 
between 128 and 255 


Returned results: status as discussed above 

NET_SEND will send a message to another station. NET_SEND 
will wait “wait” seconds for the destination station to ack- 
nowledge the message. The parameter “his_arc’, if set to zero, 
will be calculated by NET_SEND. The parameter “mess_type” 
should be greater than 127. Values between @ and 127 are 
reserved by Nestar. 

NET_RECV 


Input parameters: 


mess : buffer to receive message into 
limit : size of the receive buffer “mess” in bytes 


Returned results: 


his_id : the six byte “host_id” style address of the sender 
his_arc : the one byte station address of the sender 
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length : the length of actual message in bytes. 
Zero if nothing received 
mess_type : the message type passed by the sender 
status as discussed above 


NET_RECV will check for an incoming message and will receive 
it if present. If no message is present, NET_RECV will return a 
value of "nsr_nm”. The correct way to call NET_RECV is 


repeat 
call NET_RECV 

until returned status is not nsr_nm 
If stat is nsr_ok, the message was received correctly. Other- 
wise, the message is corrupt. 
LANGUAGE SPECIFIC FEATURES: 
4.6.1 PASCAL 
The Network Send and Receive routines for Pascal are imple- 


mented as a unit supplied in a file call NSRUNIT.ITF. The key 
declarations in this interface are: 


type 
nsr_stat = ( 
{ the following are statuses normally returned by nsr } 
nsr_ok { 0, send or receive ok }, 
nsr_nm { 1, no message for receive }, 


{ the following are errors commonly returned by nsr } 
nsr_not_open { 2, net_open has not been called }, 


nsr_sf { 3, send fail, did not get ack }, 

nsr_rf { 4, receive fail, did not get complete 
message į}, 

nsr_ovf { 5, overflow, received message was 
too large }, 
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{ the following are unusual errors returned by nsr } 
nsr_no_net { 6, network interface not present }, 
nsr_istn { 7, could not listen }, 

nsr_rb { 8, could not allocate an rb }, 

nsr_ignr { 9, could not ignore } 


); 


seconds = 0..3599; 
{A host_id is a six byte Ethernet address of a station. For nor- 
mal Nestar systems its value is set as follows: 


id[0] := 8; 

id[1] := 0; 

id[2] := 10; 

id[3] := 0; 

id[4] : 0; 

id[5] : <arc_net address of station >; 


The 8:0:10 bytes are Nestar’s manufacture ID as supplied by 
Xerox.} 


host_id = array[0..5] of byte; 
arc_addr = byte; 
msg_ptr = adsmem; 


function net_open(keep_time : seconds):nsr_stat; 
function net_close:nsr_stat; 


function net_send( 
wait : seconds; 
const his_id : host_id; 
his_arc : arc_addr; 
mess : msg_ptr; 
length : word { send message length in bytes (0..65534) }; 
mess_type : byte) : nsr_stat; 
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function net_recv( 
var his_id : host_id; 
var his_arc : arc_addr; 
mess : msg_ptr: 
limit : word { max message size 
that should be received (0..65534) |; 
var length : word { length of actual message, 
zero if nothing received }; 
var mess_type : byte) : nsr_stat; 


Note that the message buffers are passed as long pointers (type 
adsmem) so that messages can be sent to or received from 
anywhere in the address space of the 8088. Thus you could (for 
example) send or receive directly to or from the video buffer of 
the color or monochrome card. 


4.6.2 Compiled BASIC 


The Network Send and Receive routines for compiled BASIC 
are implemented by assembler routines which are linked in and 
accessed by the “CALL” command. The last parameter of each 
routine is an integer variable which returns the result status as 
defined above. Note that where integer variables are used in the 
samples, an integer variable must be used, not a real variable or 
a constant. 


call netopen(keep%, stat%) 


Input parameters: 
keep% : the packet keep time in seconds as an integer variable. 


Returned results: 
stat% : the result status. 


call netsend(pkt.wait%, dest%(0), arc%, vptr$, mlen%, type%, 
stat% ) 


Input parameters: 
pkt.wait : how long to wait for the receiver to acknowledge 
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in seconds. 

dest%: a six byte or three word integer array which holds 
the host id style address of the destination station. 

arc? : the one byte destination station address, normally 
set to zero. 

vptrs : the result of the varprt$ function on the variable 


to be sent (i.e.. vptr$=varptr$(mess(0))). 
mlen% : the length of the message in bytes (0..65534). 
type% : the type of the message, an arbitray number 
between 128 and 255. 


Returned results. 
stat% : the result status. 


call netrecv(source%(0), arc%, vptr$, limit%, mlen%, type%, 
stat%) 


Input parameters: 

vptr$ : the result of the varprt$ function on the variable 
to be received into (ie. “vptr$=varptr$(mess(0))’). 

limit% : size of the receive buffer in bytes (0..65534). 


Returned results: 

source% : a six byte or three word integer array which 
holds the "host id" style address of the source 
station. 

arc% : the one byte station address of the source station. 

mien% : the length of the message in bytes. 

type% : the type of the message, an arbitray number 
between 128 and 255. 

stat% : the result status. 


call netclose(stat%) 


Returned results: 
stat% : the result status. 
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4.6.3 COBOL 


The Network Send and Receive routines for COBOL are imple- 
mented by Assembly routines which are invoked by the host 
program using the "CALL" statement. The following data defini- 
tions and calling sequences describe their usage: 


WORKING-STORAGE SECTION. 


* Status/error codes returned by NSR routines. 
01 NSR-STAT PIC 9 COMP-O. 


88 NSR-OK VALUE 0. 
88 NSR-NO-MSG VALUE 1. 
88 NSR-NOT-OPEN VALUE 2. 
88 NSR-SEND-FAIL VALUE 3. 
88 NSR-RECV-FAIL VALUE 4. 
88 NSR-RECV-OVERFLOW VALUE 5. 
88 NSR-NO-NET VALUE 6. 
88 NSR-LSTN-FAIL VALUE 7. 
88 NSR-NO-RB VALUE 8. 
88 NSR-IGNR-FAIL VALUE 9. 


* Ethernet address (for normal Nestar systems the 
* first 5 bytes of the “host_id" must be set to 

* hex values 08 00 OA 00 00 using the following 

* initial values, and the last byte is the 

* station address). 


01 HIS-ETHER. 
02 FILLER PIC 9 COMP-0 VALUE 2048. 
02 FILLER PIC 9 COMP-0 VALUE 2560. 
02 ARCNET PIC 9 COMP-0 VALUE 0. 


* Arcnet or station address (from 1 to 255). 
01 HIS-ARC PIC 9 COMP-O. 


“ Length of message in bytes (from 0 to 32767). 
01 LEN PIC 9 COMP-O0. 


” Message type (from 128 to 255). 
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01 MSG-TYPE PIC 9 COMP-0. 


” Maximum length of message that may be received 
(from 0 to 32767). 
01 LIMIT PIC 9 COMP-O. 


“ Time in seconds (from 0 to 3599). 
01 KEEP-TIME PIC 9 COMP-O. 
01 WAIT-TIME PIC 9 COMP-O. 


* Buffers for send and receive (size may be varied). 
01 SENDBUF PIC X(100). 
01 RECVBUF PIC X(100). 


PROCEDURE DIVISION. 


CALL “"NTOPEN" USING KEEP-TIME, NSR-STAT 
“Input: KEEP-TIME. 
“Output: NSR-STAT. 


CALL “"NTSEND" USING WAIT-TIME, HIS-ETHER, HIS- 
ARC, SENDBUF, LEN, MSG-TYPE, NSR-STAT. 


“Input: WAIT-TIME, HIS-ETHER, HIS-ARC, SENDBUF, 
LEN, MSG-TYPE. 


“Output: NSR-STAT. 


CALL "NTRECV" USING HIS-ETHER, HIS-ARC, 
RECVBUF, LIMIT, LEN, MSG-TYPE, NSR-STAT. 


“Input: RECVBUF, LIMIT. 
“Output: HIS-ETHER, HIS-ARC, LEN, MSG-TYPE, NSR- 


STAT. 
CALL "NTCLSE" USING NSR-STAT. 
“Input: none. 


“Output: NSR-STAT 
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4.6.4 C 


The Network Send and Receive routines for C are implemented 
in Assembly language. The routines (NETOPEN, NETCLSE, 
NETSEND, and NETRECV) are called as functions from a C 
program and may be linked in from the library NETC.LIB. The 
header file NSRC.H to be included by the calling C program, 
contains the following constant definitions and function descrip- 
tions: 


i* Status codes: ” 


#define NSR_OK 0 
:" send or receive ok ’ 
#define NSR_NM 1 


»“ NO Message for receive ” 


/“Common error codes’ *; 

#define NSR_NOT_OPEN 2 
/* netopen has not been called ~ 

#define NSR_SF 3 
i” send failed */ 

#define NSR_RF 4 
1” receive failed */ 

#define NSR_OVF 5 
:” overflow, received message was too 

large */ 


:* Unusual error codes: `. 


#define NSR_NO_NET 6 
i" network interface is not available “/ 

#define NSR_LSTN 7 
/* listen on wks failed */ 

#define NSR_RB 8 
/* could not allocate an request block */ 

#define NSR_IGNR 9 


/* ignore failed `; 


4-28 


PROGRAMMING 
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‘int NETOPEN (keep_time) 
; int keep_time: (© number of seconds 
(0..3599) *) 


; Input: keep_time. 
; Output: status code (returned as function 
value). 


: int NETCLSE O 


; Input none. 
; Output: status code (returned as function 
value). 


, int NETSEND (wait, his_ether, his_arc, msgptr, 
len, msgtype) 

; Int wait; (" number of seconds (0.. 
; 3599) to wait for accept *) 
; int ("his_ether)[3]; (“ destination’s ethernet 

; address (3 words) *) 


; char his_arc; (* destination’s arcnet 
address “) 

char “msgptr; (“ message to send `) 
; int len; (* length of message in 
; bytes *) 
; char msgtype; (* message type `) 


; Input: wait, his_ether, his_arc, msgptr, len, 
msgtype. 

; Output: status code (returned as function 
value). 
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in NETRECV (his ether, his_ arc, msgptr, 
: limit len, msgtype) 


; int ("his_ether)[3];  (* sender's ethernet 

; address (3 words) `”) 

; char “his_arc; (* sender's arcnet 

f address “*) 

; char “msgptr: (* buffer to receive 
message into *) 

; int limit; (* maximum size of 

: message to receive `) 
; int “len; (* length of actual 

l message, 0 of nothing 
received *) 

; char “msgtype; (* message type received") 


; Input: msgptr, limit. 
; Output: his_ether, his_arc, len, msgtype, status 
: code (returned as; function value). 


1 


wy 
i 


4.6.5 Assembler 


An “include” file called "NSR.ASM" is provided for access to the 
Network Send and Receive routines from assembler. 
“include” files must be included before NSR.ASM. The first is 
L4ASM.ITF, the interface that equates to the lower level network 
routines. The second is L4LOC.ASM, used to locate the level 
four network routines. Your applications should contain the lines 


INCLUDE L4ASM.ITF 
INCLUDE L4LOC.ASM 
INCLUDE NSR.ASM 


The four entry points are declared as "near" procedures. 
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The assignment of parameters to registers is as follows: 
ANET_OPEN 


input 
ax : keep time in seconds 


output 
ax nsr stat 


ANET CLOSE 


input 
none 


output 
ax : status 


ANET_SEND 


input 
ax : message wait in seconds 
es:di : pointer to destination host id 
di : his_arc, if set to zero use last byte of host id 
bx : segment of message 
cx : offset of message 


si : length of message in bytes 
dh : message type, must be > 127 


output 
ax : status 


ANET_RECV 


input 
es:di : pointer to storage for source host id. 
bx : segment of message buffer 
cx : offset of message buffer 
dx : limit to size of message buffer in bytes 
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output 
es:di : points to host id of source 
dl : station number of source 
cx : length of message 
dh : message type 
ax : Status 


4.7 BRUN 


The BRUN command is available through the network device 
driver BRUN allows a program to be downloaded from a binary 
(T- B) volume on a file server to a workstation and then exe- 
cuted The program must be loaded in a designated memory 
location. When necessary, the program will be called as a sub- 
routine by the driver. For more on BRUN see Chapter 5 in the 
PLAN Series Network Command Reference Manual. 


Since the program is invoked by the device driver, DOS function 
calls are not allowed. Only BIOS function calls can be issued. 


When entering the program a private stack must be allocated. 
Also all registers must be preserved. To exit back to the driver 
use a RET instruction. The driver will then return the string “+0, 
OK". See the sample program below. 


cseg segment public "code" 
assume cs:cseg,ds:nothing,ss:nothing,es:nothing 


org 100h 
subpgm proc far defined as an external 
¡subroutine 
entry: jmp start 
write_tty equ OEH 
video_call equ 10H 
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ss_save dw ? 
sp_save dw ? 
db 20 dup ("STACK") __ ;local stack 
stack_top equ $ 
hello db “Hello World!",13,10,0 ;message to 
‘display 
start: 
push ax ‘free a register 
push ds ‘save current data 
‘segment 
mov ax,cs ‘align DS to our data 
‘space 
mov ds,ax 
mov ss_save,ss ‘save caller's ss:sp 
mov sp_Save,sp 
cli establish our own stack 
mov SS,ax stack segment, same as 
;data segment 
mov sp,offset stack_top 
sti 
push bx ‘Save remaining registers 
push Cx 
push dx 
push si 
push di 
push bp 
push es 
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mov si.offset hello 
pr_next: 
mov al [si] ;get a char 
cmp al,0 send of string? 
je pr_end 
mov bx,0 ;page 0, foreground 0 
mov ah,write_tty ;char out function code 
int video_call ;call BIOS routine 
inc si ‘next char 
jmp pr_next 
pr_end: 
pop es ‘restore register 
pop bp 
pop di 
pop si 
pop dx 
pop Cx 
pop bx 
cli ‘recover caller's stack 
mov ss,ss_save 
mov sp,sp_save 
sti 
pop ds ‘restore caller's data 
segment 
pop ax 
ret 


subpgm endp 
cseg ends 


end subpgm 
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The sample program is then assembled, linked, and converted 
to a binary file, and saved to a T B volume on the file server, 
as shown below: 


>- debug nest.com ‘execute the NEST program under 
‘debugger 


-r ‘NEST is loaded at segment 1BC7. for 
:18C bytes 


AX=0000 BX=0000 CxX=018C ODX=0000 SP=FFFE BP=0000 S$!=0000 DI=-0000 
OS=1BC7 ES=18C7 SS=18C7 CS=1BC7 !P=0100 NV UP EI PL NZ NA PO NC 


1BC7 0100 EB6B JMP 0160 

-n subpgm.bin ‘name of binary file to load 

-1 2000:100 ‘load to free memory above NEST 
-r ‘display registers again to find length 


; of subpgm.bin (in BX/CX) 


AX=0000 BX=0000 CX=00C2 DX=0000 SP=FFFE ®8P=0000 SI=0000 D!=0000 
DS=1BC7 &S=18C7 SS=1BC7 CS=18C7 !P=0100 NV UP E! PL NZ NA PO NC 
18C7'0100 €B6B JMP 016D 


-n CREATE -MAIN/EXAMPLE: SUBPGM, T =B,SIZE =$C2.c 
-g -create a binary volume large enough 


-n BSAVE ;MAIN/EXAMPLE/SUBPGM,FROM = $20000100, 

SIZE =$C2.c 
‘save image from memory to binary 
svolume 


Use the BRUN command to load and execute the saved pro- 
gram as show below: 


-sNEST BRUN ‘MAIN. EXAMPLE SUBPGM 
Hello World ! 


The binary image will be loaded to the same memory location 
from which it was saved (for example, 2000:0100). 
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The BRUN command can also be issued from within an applica- 
tion by specifying a new load address where space is available. 
For example, 


BRUN ;MAIN; EXAMPLE/SUBPGM,LOAD = $30000000 


4.8 Multi-user Applications 


Section 4.8.1 discusses design issues, with their requirements 
and possible solutions, for programmers planning to build multi- 
user applications. 


In our discussion we develop a set of recommended “require- 
ments,” which forms the basis for Section 4.8.2, the Program- 
ming outline. 


The paragraphs below assume you are quite familiar with DOS. 
If your first job is to program your application, you will probably 
find it better to skip Section 4.8.1 on Design Issues and use the 
approach outlined in Section 4.8.2. 


4.8.1 Design Issues 


Filing system 


Should you use your programming language's standard filing 
system, or should you write your own? 


Obviously use of a standard filing system, where available, is to 
be preferred. But DOS buffers disk sectors so that 


@ you can read a record and not get the latest copy from the 
disk. If you have already read the disk sector when another 
user writes a new copy of the record to the disk, your pro- 
gram may get the original from the DOS buffer rather than the 
updated version when it subsequently reads the record. 
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e when DOS writes a record, it will probably not physically write 
the whole record to disk. It will go into DOS’s buffers for later 
writing when a whole sector's worth of information has been 
written. 


DOS's buffering mechanism can be used to advantage in 
single-user programs, but for multi-user applications it is a hin- 
drance. You can flush buffers, however, thereby guaranteeing 
physical O to the disk, by using the DOS “flush buffers” call 
(INT 21H, code @D. We use this call in the Programming out- 
line to show how to use your language's normal file system in 
Multi-user applications. 


Buffers 


Buffers are an important factor in multi-user programming. 
Chapter 4 of the /BM DOS Version 3.10 Technical Reference 
contains information about them. Here we present further detail. 


e Buffers are used for FATs, for Directory sectors, for the last 
sector of a downloaded program, and for buffering single- 
record I/O. 


e Buffers are not used for multiple-sector transfers, such as 
program downloading. (The last sector of a program is buf- 
fered because it is read in via a single sector read call so that 
only part of the block can be delivered to the requestor.) 


e Although buffers are used for diskette files in the above ways, 
they are not normally re-used, and so they have no effect on 
performance because floppy disks can change. This fact does 
not apply to shared disks, so buffering can increase perfor- 
mance when used on network volumes. 


è Closing a file performs physica! O of any unwritten sectors in 
the file and of the relevant directory sector. But these sectors 
are also buffered, so requests to read the same sectors need 
not carry out physical |-O. 
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e Flushing buffers using INT 21 function ODH writes any unwrit- 
ten buffers to the correct sectors and then marks all sectors 
“invalid.” Further requests for sectors in the buffers before the 
“flush” call will have to perform physical I/O. In multi-user 
applications, this action means that the latest copy of a record 
will be read after a “flush,” but any opened files will not have 
their directory sectors written by a “flush” since only the 
“close” call does this. 


e DOS handles record operations "correctly" after a “flush” call. 
It will read all sectors which the record will alter into the 
buffers before writing the record. 


e When DOS makes a "DIR" call, it first reads all the directory 
sectors into memory and then lists the files. To write the 
“nnnn bytes free” message, it also reads the FAT. All these 
sectors are buffered so that, if they fit into memory, a subse- 
quent DIR is faster. 


è When DOS loads a program, it reads all the directory sectors 
one by one, again buffering them, and then searches for the 
file’s entry (presumably because of all the different endings a 
program may have: COM, EXE, and BAT). It reads the FAT, 
via the buffers, to follow the chain of clusters (allocation units) 
for loading the program. 


You can improve program downloading time either by increas- 
ing the number of buffers, so that the directory sectors do not 
have to be physically read, or by using smaller directories. 


e When DOS opens a file, it is more selective than when it 
downloads a program. It reads the directory one sector at a 
time until it finds the file's entry. It does not read the whole 
directory, regariess of where the file is. This means that if you 
have to open a file many times in an application, you can 
speed things up by making that file one of the first sixteen 
files in the directory. (The first sixteen directory entries fit into 
the first directory sector.) 
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Locking 


In programming multi-user applications you must ensure that the 
users do not interfere with each other's updating of the files. 
PLAN file servers provide locks to ensure this. Locks are simply 
names, locked by one station at the disk server, which cannot 
then be locked by any other users. 


How do you use locks to prevent interference? The simplest 
way is to use one lock for the whole database. This procedure 
has the advantage of being straightforward, and it keeps lock- 
processing to a minimum. On the other hand. it denies access 
to the whole database when perhaps only three or four records 
out of thousands are being updated. This is a coarse” 
approach to locking. 


The other extreme is to lock precisely those areas of the data 
base which are being updated. This takes more processing 
time, depending on the number of locks held for any one tran- 
saction, but it allows many users to update different parts of the 
database at the same time. This is normally referred to as 
“record locking.” 


There is a potential pitfall in using "record locking" with PLAN 
file servers. Imagine that you have a file DFILE, organized as 
200-byte records. Just over two records fit into each (512 byte 
DOS) sector, the unit of physical O. Assume records 0, 1, and 
a bit of record 2 are in the first sector of DFILE. You might write 
code like this: 


(1) get record number "nn" to work on 

(2) lock the string "DFILEnn” as a record lock of "nn" in DFILE 
(3) read the current value of the record 

(4) update the record in memory 


(5) flush the buffers (to ensure rereading the relevant sector in 
the file) 

(6) write record “nn” (which causes DOS to reread the required 
sectors for record ‘nn’ and write the new record into these 
buffered sectors) 
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(7) flush the buffers (which causes DOS to rewrite the sectors) 
(8) unlock ‘DFILEnn 


This approach stops two users working on the same record "nn" 
but does not prevent them working on adjacent records which fit 
into the same sector. You might then get the following 
sequence: 


Time UserA User B E 7 
1 write record 2 write record 3 
2 DOS reads sectors 0 & 1 
3 DOS reads sector 1 
4 record 2 written into 


buffered sectors 0 & 1 
5 record 3 written into 
buffered sector 1 
6 flush buffers 
DOS writes sectors 0 & 1 
8 flush buffers 
9 DOS writes sector 1 


The result is that part of record 2 in sector O is successfully 
updated. but the part in sector 1 stays the same. 


You can get around this problem by adding locks for the 
relevant sectors as well, but the increased lock-processing time 
will probably offset any advantages in not locking the whole 
database. Our conclusion is that record locking, as widely 
understood, is not the most effective approach to locking for 
PLAN file servers. 


We thus use the styles of locking in the Programming outline 
We lock a name related to a particular record to indicate that an 
image of the record is in the memory of a user's PC and Is 
being updated. (This is not record locking in the normal sense of 
the term.) For protecting database updates from interference we 
use the coarse style of locking, and for allocating records we will 
use the LOCK- COMMAND, which returns incrementing values 
each time it is used. 
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Preallocation 


The final issue is whether or not to preallocate the database. 
We recommend that you do and, in particular, that 


e you use one dedicated volume on the shared disk for all data 
files in a particular operation. 


è you set all files with the maximum number of records to be 
allowed. If you do so, you can open each file only once. 


If you use files which can grow dynamically, their directory 
entries may change every time the file is updated. To preserve 
correctness you should open every file that may grow each time 
it is going to be used. Your design decision is than whether or 
not having files that can grow at different rates is worth the extra 
lock-up time for re-opening files. 


When using files which grow, remember that 


è you should flush the buffers before re-opening the file so that 
you get the correct length of the file, and 


è you can cut down on resulting physical I/O if the files are in 
the first directory sector (that is, one of the first sixteen files 
created on the volume). See the remark above about DOS’s 
method of opening files. 


The Programming outline assumes files with static length. 


4.8.2 Programming Outline 
This section gives a recommended approach to application pro- 


gramming. In doing so, we make some assumptions. discussed 
in the previous section. 


èe Your high-level language's filing system will perform record 
I/O (so our treatment will be a general level) 
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e The maximum number of users of any one database is 5 or 6, 
so we can use coarse locking. 


è You want to achieve correct operation under all conditions. At 
the expense of increased run-time, we can pre-allocate the 
files with a maximum of number of records. 


We will also assume a general structure of the files: 


(1) a main data file called MASTER-FILE; 


(2) Write access to any index associated with this file that 
would be covered by the same lock as the master file; 


(3) A lock (ALLOCATION) set with a value of the last record 
allocated. 


Installation 


Set up one small volume to hold your programs 
({APPLICATIONS/PROGRAM) and another to hold the data 
base (//DATA/DATA1). Use these only as live volumes. Backup 
or development versions of the files and program source code 
should go on other volumes or other media. 


PROGRAM will thus need 320K at most, and you can probably 
calculate the required size of DATA if you allow 9K for DOS 
overhead and remember that each file may have a few kilobytes 
unused in the last cluster. 


To set up PROGRAM just copy the program files into it. You 
may then want to make the volume read-only to protect the pro- 
grams from change. 


To set up DATA create each file individually. Write a utility for 


each file which asks for the number of records and writes the 
same number of null records. 
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Program Startup 


It is quite in order, given the number of drives available, to fix 
the drives your application will use. To allow users to run the 
program. write a batch file CALLMAIN.BAT to go on the user's 
library volume. 


NET MOUNT APPLICATION: PROGRAM.1|:MAINPROG 
NET MOUNT ‘DATA/DATA1,J:,RW.SHR 
MAINPROG 


This fixes PROGRAM as drive |: and DATA as J:. while 
MAINPROG ıs the name of your main entry point for the appli- 
cation. 


MAINPROG should now open all the relevant files on J:. (If you 
have data files which can grow, you will have to open them in 
the main loop.) If the lock ALLOCATION has not been set, you 
should set it to the last record +1 into file DATA. This is the first 
free record. 


The main loop consists of reading which option the reader 
requires. Include a “flush buffers” call in the main loop. Your 
action will sometimes be redundant, but there is no harm in 
redundant calls. 


Data Entry 


Here is an outline of a data entry routine. 


(1) Flush buffers (=Disk Reset to DOS). 
(2) Lock ALLOCATION returning nn (next free record). 


(3) Lock "RECORDnn” (Signal that this record is in our 
memory). If locked, print “Waiting” message and goto 3. 


(4) Get input from user. 


(5) Lock "MASTER-FILE”. If locked, print “Waiting” message, 
delay one second, and go to (5). 
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(6) Write record “nn”. 


(7) Index if appropriate. (Order of 6 and 7 is important here. 
Put a valid record into the file before indexing it.) 


(8) Flush buffers. 
(9) Unlock "RECORDnn". 
(10) Unlock "MASTER-FILE”. 


In general we ensure a buffer flushed state before every lock 
and unlock. Flushing before a lock ensures we re-read informa- 
tion from the disk. Flushing after an unlock ensures we physi- 
cally write information to the disk. 


For debugging it is useful to add the command REMOUNT 
I:,RW,UPD after step (2) and REMOUNT |:,RO,SHR after step 
(7). The first remount will return 31, IN USE if another station 
has the volume mounted for work. This will indicate that there is 
an error in your lock and unlock routine or that another applica- 
tion has the volume mounted read/write. 


In general you should always check for the appropriate result 
code returned from the command and never just assume that it 
was all right. A good test of the robustness of an applicator is to 
unplug your machine from the network while your application is 
running. The network will time out and eventually an error to 
your program. 


Updating a Record 


(1) Get the record number “nn” from user or index. 
(2) Flush buffers. 


(3) Lock “RECORDnn” (Signal that this record is in our 
memory). If locked, print “Waiting” message, wait one 
second and goto 3. 


(4) Read old record “nn”. 
(5) Get new field values from user. 
(6) Flush buffers. 
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(7) Lock ‘MASTER-FILE”. If locked, print “waiting” message, 
wait one second and go to (7). 


(8) Write record “nn”. 

(9) Re-index if appropriate. 
(10) Flush buffers 

(11) Unlock “RECORDnn". 
(12) Unlock "MASTER-FILE". 
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Chapter 5 


Additional Utilities 


5.0 Introduction 


In addition to the NET program (Section 2.3), the network pro- 
vides a number of utility programs for use at the individual net- 
work stations. Before attempting to execute them, check for the 
names of the volumes on which they reside at your installation 
(usually a volume called /MAIN/LIB/IBMPC/DOS). 


STARTUP executes a file of commands on the user's default 
volume at initialization time. 


TCOPY allows the user to copy text files on Type =! virtual 
volumes to and from Type=T network text volumes. 


COUNT allows the user to analyze network activity by counting 
packets sent by stations on the network. 


NEST allows the user to direct file server response codes to the 
DOS condition ERRORLEVEL instead of to the workstation con- 
sole screen. 


NWCMDS allows access to the network and virtual printer from 
within any program environment via a scrolling window which 
appears on your screen. 


VPCMDS allows access to the virtual printer only from within 
(same as above). 


CARDCHK is used to test for and diagnose problems in PLAN 
Series IBM PC Network Interface Cards. 


NEWUSER enrolls a first time user on the network and creates 
a personal work space on the network disk. See Section 
1.11.2.1. 


SETPRINT allows you to specify header items and write them 
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directly to a virtual printer or to a file for use later. See Section 
3.2.4. 


NETCONFG modifies the parameters in the network driver. See 
Section 1.12.6. 


PRINTQ, a program run at at IBM PC DOS workstation, allows 
you to track the progress of a print request. See Section 3.5. 


5.1 STARTUP Command Program 


STARTUP is a facility that allows users to issue file server com- 
mands automatically. This allows automatic configuration of the 
user's environment for user convenience or to provide a “turn- 
key” system. 


Note that for stations that boot from a virtual volume the use of 
STARTUP is not typically needed since most of its capabilities 
exist in the BOOT program. Because STARTUP is a large pro- 
gram, eliminating it from the boot process can speed booting 
considerably. STARTUP is useful when booting from local 
(Real) disks. 


STARTUP is usually invoked by having AUTOEXEC.BAT on 
drive A: with the following contents: 


NEST MOUNT //USERS/GEORGE/1,E:,RW 
E: 
NEST MOUNT //LIB/IBMPC/DOS,L:,RO,SHR 
L: STARTUP STARTCMD 


This sets the default drive to E: and then runs L:STARTUP to 
read commands from the text file called E:STARTCMD. 


STARTUP reads commands from the filename specified in the 
command line when STARTUP is called. If no filename is speci- 
fied, it attempts to read the STARTCMD file from the current 
disk. 
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Commands in the STARTUP command file (STARTCMD) are as 
follows: 
;anystring 


Ignored as a comment. 


cmd ; comment 

Anything following a “;" and ending with a “Return is a com: 
ment. 

NOECHO cmd 


Doesn't print the command before executing it. 


NET fileservercmd 


Executes the file server command. 


SET DATE 

Sets the DOS system date and time. When your station boots 
from a virtual volume, the date and time is set by the CLOCKS 
device driver (Section 1.12.5). 

SET USER name 

Sets a fileserver lock with the name USER.name. Lock is set in 


SHR mode. Useful for other stations or programs to identify the 
current user. 
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SHOW VERSION 

Displays the version number of the STARTUP program. 

SHOW DATE 

SHOW TIME 

SHOW DATETIME 

SHOW FORMDATE 

These all display the current day of the week, date and time in 
the format DAY dd-mon-yyyy hh:mm:ss. 

PRINT string 


Prints the string on the screen. 


TYPE filespec 


Displays the contents of the file specified on the screen. 


NEWS 


Displays the contents of L:NEWS if present. 


CLEAR 


Clears the screen. 
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ASK cmd 

ASK =Y cmd 

ASK =N cmd 

ASK cmd PROMPT string 


These ask the user before executing the command given either 
with a default prompt string or with the prompt string given. The 
default answer (yes or no) can be given with the =Y or =N 
clause. 


CONTINUE 

CONTINUE=Y 
CONTINUE =N 

CONTINUE PROMPT string 


Ask the user whether to continue STARTCMD processing. 
Default answers (yes or no) can be given with the =Y or =N 
clause. The default prompt string may be overridden with the 
prompt string given. 


PASSWORD 
PASSWORD PROMPT string 


These ask the user for a password (which is not echoed on the 
screen) and then issue a FS command to set the private pass- 
word (NET SET PRVPW=password). 


ENTER 
ENTER string 
ENTER PROMPT string 


These ask the user to enter a command to be executed 
(ENTER) or to complete a partial command (ENTER string) to 
be executed. The default prompt may be overridden with the 
PROMPT clause. 


STARTUP 


QUIT 


Quits the program. 


An example of a STARTCMD file might read as follows’ 


‘this is a sample startcmd file 

clear 

print 

print -- this is , USERS/ABC/1 -- 
print 

set user abc 

set date ; sets the date in DOS 
noecho show date ;shows current date and time 
noecho net set drive c: d: virtual 

net set dir mainsusers 

password prompt enter private password 
continue =y prompt want to do mounts 
net mount abc/temp,f:,rw,shr 

news 

type reminders 


This list of program commands begins with a comment ignored 
by the STARTUP program ("this is a sample..."). Then the 
screen is cleared and "THIS IS /MAIN/USERS/ABC/1" is printed 
on the user station screen. 


The program then sets the system date to the current file server 
date and displays the date. 


A default partial pathname is set as well as a private password 
that may be required to access directories or virtual volumes. 


The virtual volume MAIN USERS,ABC: TEMP is mounted on 
drive F: for shared, read/write use. 


The current news file on drive L, if present, prints the user's 
reminders file, if that also is present. 
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5.2 TCOPY 
TCOPY is a utility used to transfer text files from one environ- 
ment to another. It is used to copy text files from the current 
environment into Type=Text volumes and to copy Type=Text 
volumes (perhaps created by TCOPY in some other environ- 
ment) into text files in volumes in the current environment. To 
execute the program, run TCOPY, which is usually found on a 
shared library volume. 
TCOPY will start by asking the question: 

Is the source a D(OS file or a N(etwork volume? 
Type “D” or "N" depending on which direction you wish to copy. 
The volume containing, or to contain, the Pascal file must be 
currently mounted; it must be mounted Read/Write if it is to be 
the destination volume. 
If the source is a DOS file, the program will then ask: 

Source file name: 


to which you should type the name of the source DOS file in 
standard DOS format, that is, [drive:]filename[.ext]. 


Note: The source file should always be a text file, not a code, 
binary, or data file. 


The program will then ask: 
Destination volume name: 


to which you should type the network pathname of the volume 
to which the source file will be copied. 


TCOPY will then ask: 


Replace destination [N]? 
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A response of "Y" causes the destination volume to be replaced 
by the contents of the source if the destination exists. If the des- 
tination volume does not exist, it will be created. “N” causes an 
error message if the destination volume exists. Pressing 
<<Return> is the same as typing "N". 


If the destination is a pre-existing network volume that will be 
replaced, any passwords or non-default access rights on the ori- 
ginal volume will be transferred automatically to the new 
volume. The size of the new volume will be the larger of the old 
and new volume sizes. 
TCOPY then asks: 

Delete source [N]? 
If "Y" is entered, the source file will be deleted when the copy is 
completed. Otherwise the source will be kept. Pressing 
<Return> is the same as typing "N". 
TCOPY will then copy the contents of the source file to the 
Type=T (Text) volume. A period (.) is printed for each line 
copied. When the copy is complete, the program will exit. 
If the source is a network volume, TCOPY asks: 


Source volume name: 


The name must be the pathname of a Type=T (Text) volume on 
a file server disk. TCOPY then asks: 


Destination file name: 


Type the name of the DOS file to which the source volume will 
be copied. 


Note: The destination file should always be a text file, not a 
code, binary, or data file. 


TCOPY then asks: 


TCOPY 


Replace destination [N]? 
followed by 
Delete source [N]? 


Answers to these questions are discussed above. Answering 
"Y" to “Replace destination?" in this case, however, will result in 
the destination file being replaced, not the whole volume upon 
which the file resides. 


TCOPY will then copy the contents of the Text volume to the 
destination file. When the copy is completed, TCOPY will exit. 


lf the source and destination volume and file are on different file 
servers, the default file server must be the one upon which the 
T=T volume resides, whether the volume is source or destina 
tion. The volume containing the source or destination DOS file 
must be mounted on a drive set to the other file server 


NOTE: If TCOPY aborts during a file-to-text volume copy and 
the destination text volume is password-protected against 
erase/delete, TCOPY will be unable to delete the partially- 
formed destination volume. You should delete this volume 
manually in order to prevent its accidental use. 


5.2.1 Entering Parameters on the Command Line 


As an alternative to the interactive method described above, you 
can enter the information TCOPY needs on the command line 
after the word "TCOPY". The syntax for DOS file-to-network 
volume transfer is 


TCOPY DOS (or "D"), source file name, destination volume 
name, REPLACE (or "R", “Y”, or “N"), DELETE (or "D", "Y", or 
"N") 


The syntax for network volume-to-DOS file transfer is: 


TCOPY NETWORK (or "N"), source volume name, destination 
file name, REPLACE (or "R", “Y", or "N"), DELETE (or “D”, "Y". 
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or "N") 


Note that parameters may be entered as uppercase or lower- 
case. 


Parameters must be separated by commas. The last two 
parameters, REPLACE and DELETE, are optional. If one or 
both are left out, the default (not replacing the destination and 
not deleting the source) takes effect. If you use "R" or “D” or 
REPLACE or DELETE, the order of the two does not matter. If 
you use "Y" or "N", TCOPY assumes you are answering the 
questions in the order they would be asked by the interactive 
version (described above). 

Here are some examples: 

TCOPY D, F:FILE.TXT, ,USERS‘ME;STUFF,N,Y 

This form answers questions as they would be asked by the 
interactive version. 


TCOPY NETWORK, /,;USERS/ME/TEXT2,E:TEXT2 


Defaults to not replace, not delete. 


TCOPY ,D, TEXTFILE, TEXTVOL, DELETE 


copies from file TEXTFILE on logged-in drive to volume 
TEXTVOL in default directory, deleting source. 


TCOPY N,N,N,N,N 


copies from volume N in default directory to file N on logged-in 
drive, not deleting source or replacing destination. 
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5.2.2 TCOPYing from the Keyboard 
You can use TCOPY to type text from the workstation keyboard 
directly into a network volume (in much the same way you 
would use the DOS "COPY CON: filename” command to type 
text into a DOS file. 
To do so at the DOS prompt, type E> TCOPY 
Answer the “D(OS file or N(etwork volume” prompt with "D". 
When prompted for the source file name, enter 

User 
Reply to the prompt 

Replace destination [N]? 
with "Y" or "N”. To the prompt 

Delete source [N]? 
press <Return->. 
Next enter the text to be placed in the T=T volume. After each 
<Return> that you enter, TCOPY will place a period at the start 
of the next line to signify that the previous line has been pro- 
cessed. 
Terminate your input by pressing <Ctrl> Z or function key 6 
(F6). 
5.2.3 TCOPYing from a Text Volume to Your Screen 
Answer the "D(OS file or N(etwork volume” prompt with "N". 
Specify source volume when prompted. When prompted for the 


destination file name, enter “user” or “con”. In response to the 
prompt “Replace destination [N]?", you must type “Y”. 
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5.3 COUNT 


The COUNT network monitor program tabulates network activity 
and displays the data in two screens. (If you have multiple 
fileservers, it can be a useful tool in balancing the network load 
among the fileservers ) 


COUNT's two screens are arranged in the following four figures: 


(1) A moving skyline graph that shows how many packets per 
second the network has carried for the last 70 seconds. 
(Figure 5-1) 

(2) A bar graph that displays the amount of time taken for the 
token to traverse the network. (Figure 5-2) 


(3) A matrix of station addresses that displays stations on the 
network and their degree of activity. (Figure 5-3) 


(4) A bar graph that displays how many packets per second 
the network is carrying. (Figure 5-4) 


5.3.1 Skyline/Token Timing Screen 


When the user invokes COUNT, the program calibrates itself for 
several seconds. It then displays a screen which includes the 
skyline graph and the token timing graph and starts up the sky- 
line graph. Only one of these two graphs can function at a time. 


The skyline graph comprises the upper part of the screen. Every 
second a vertical bar is drawn corresponding to the number of 
packets (up to 1000) the network has carried during that 
second. Because the graph is shifted to the left each second, it 
presents a record of the amount of network activity that has 
occurred for the past 70 seconds. 


The horizontal axis represents time. The vertical axis measures 
the number of packets sent. In the sample screen below a peak 
of 700 packets occurred sixty seconds ago. and the network 
activity has since fallen to 100 packets each second. 
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Figure 5-1 


Skyline Timing Screen 


COUNT -- Network Performance Monitor Version 4.0b 





Copyright 1984 Nestar Systems, Inc. PLAN Server (TM) software 
SKYLINE GRAPH OF PACKETS TRANSMITTED EVERY SECOND 
l | 
900+ +900 
| | 
| | 
700+ +700 
| | 
| | 
500+ +500 
| | 
| i 
300+ +300 
| | 
| | 
100+ +100 
0 0 
SECONDS ACO: 60 50 40 30 20 10 0 
TOKEN TRANSIT TIME IN MILLISECONDS 
] 
0-------------- bossssstsesoees= lrans inaa SNe ead EH Qrecssasesres-—= 5 


Press: (M)atrix (S)kyline (T)oken (Q)uit 


Press: (M)atrix (S)kyline (T)oken (Q)uit 


The menu line at the bottom of the screen presents the following 
options: 


M-switches to the matrix screen 

S-starts the skyline graph and stops the token timing graph 
T-starts the token timing graph and stops the skyline graph 
Q-quits COUNT and returns to DOS 
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To activate any of these choices, simply type the appropriate 
letter on the keyboard. 


If you select "T", the token timing graph option, the skyline 
graph stops moving, and the bar graph in the lower part of the 
screen becomes active. The token timing bar graph measures 
how long it takes the network token to visit all the stations on 
the network. 


When a station wants to send a message on the network, it 
waits until the token visits it. Thus this measurement parallels 
the "response" time on a timesharing system. It indicates how 
often the network is available to serve each station. 


The next figure depicts the token timing graph in action. The bar 
shows the token taking about two milliseconds to traverse the 
network. The mark to the right of the bar graph indicates the 
maximum time in milliseconds that has occurred within the past 
half second. 


5-14 


A 


COUNT 


Figure 5-2 


Token Timing Screen 


COUNT -- Network Performance Monitor Version 4.0b 
Copyright 1984 Nestar Systems, Inc. PLAN Server (TM) software 
SKYLINE GRAPH OF PACKETS TRANSMITTED EVERY SECOND 
l | 
900+ +900 
| | 
| l 
700+ +700 
| | 
l | 
500+ +500 















300+ +300 
| | 
l | 
100+ +100 
0 | 0 
SECONDS AGO: 60 50 40 30 20 10 0 
TOKEN TRANSIT TIME IN MILLISECONDS 
0-------------- |--------------- 2--------------- J--------------- 4--------------- 5 


Press: (M)atrix (S)kyline (T)oken (Q)uit 
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5.3.2 Matrix Screen 


All communications on the network involve the exchange of 
messages, or packets, between network stations. A typical net- 
work transaction (for example. a virtual disk I/O request or file 
server command and response) is a sequence of messages. 
Thus a network transaction may require from several packets to 
several hundred packets. 


The matrix screen (Figure 5-3) counts and displays the number 
of packets sent by every station on the network. A bar graph 
indicates overall network activity in packets per second. The 
screen also indicates the addresses of all station Network Inter- 
face Cards (NIC's) connected to the network. 


The menu line at the bottom of the screen presents the following 
choices: 


L-locate function 

M-meter toggle 

Z-zero function 

S-erases the matrix screen and starts the skyline graph 
T-erases the matrix scrren and starts the token timing graph 
Q-quits COUNT and returns to DOS 


The "L" or “locate function” option updates the display of all 
powered-on NICs on the network. The "M" or "meter toggle” 
option switches the packets-per-second meter between linear 
and logarithmic scales. (Figure 5-3 displays a linear scale. Fig- 
ure 5-4 shows a logarithmic scale.) The "Z" or "zero function” 
option resets all of the counters. The "S", "T", and "Q" options 
are self-explanatory. 


The 16 x 16 matrix fills most of the screen. Each cell of the 
matrix represents one of 255 possible station addresses 
(address 00 is illegal and should not be used). A station cell 
shows either the number of packets that the station has 
transmitted or a special character that indicates the status of 
that station: 
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* the station is powered on but has sent no packets 


+the station has been added to the network since the last 
locate or zero command 


- the station has been removed from the network since the last 
locate or zero command 


The horizontal label is the least significant digit of the station 
address in hexadecimal. The vertical label is the most signifi- 
cant. For example, station $0F is located in the upper right 
corner of the matrix, and station $FO is in the lower left corner 
Normally the file server is address $FE (bottom line, second 
from the right). 


For example, if stations $90 and $36 are active and talking to 
the file server, the screen will appear as depicted below. 


COUNT 


Figure 5-3 


Matrix Screen 
(Linear Scale) 


COUNT -- Network Performance Monitor Version 4.0b 
Copyright 1984 Nestar Systems, Inc. PLAN Server (TM) software 
1 2 3 4 5 6 7 8 9 a b c d e f 

0 . e . . . kad .0 . a e e . ° . 

1 » * e e e e e. ol . e e e ° ° . 

2 * * è è é è «2 23 $ 95 

3 . x ° 85 1 A -3 F . 7 

4 32 è ‘ $ .4 è š * a . 

5 P . é s .5 23 8? å g s 

6 . e 6 e s e . » 

7 7 * % x7 * * 2 r e * 

8 ° 7 46 8 113 r , . . 

9 es . * . #9 * . . . e ° * 

a 5 A A -a ‘ . ə bal 

b í ë ob e ° . . . 

c é 16 7 2c è . . 

d 7 27 7 5 9 i 7 33d è . . * P . Š . 

e 103 . 2 . . 2 . ee . . * * . ° e . 

£ 35 . * : 12 ° A 21€ 583 è . A . - 504 $ 
0 1 2 3 4 5 6 7 8 9 a b c d e f 

48 online stations 1855 packets and 3 recons since 16:41 on 2/03 

Packets per second 
eS y 
0-----~--~--- 200------------ 400------------ 600------------ 800------------- 1000 


Press: L(ocate) M(eter lin -> log) Zero) Skyline) Token) Quit) 


Here station $90 has sent 113 packets. station $36 has sent 12 
and the file server (station $FE) has sent 563 packets. Station 
$4D has a happy face in its cell, identifying the station running 
COUNT. Station $24 has left the network since the program was 
started or the counters last reset. 
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The program shows packets sent or received by a station but 
does not show the origin or destination. However stations of ori- 
gin or destination can usually be inferred by looking for stations 
that are active at the same time. 


An additional information line appears directly below the matrix. 
The first part of the line displays the number of active (powered 
on) stations. The last part of the line shows a count of the total 
number of packets that have been sent by all stations and the 
number of network reconfigurations since the display was last 
“zeroed,” or reinitialized, along with the date and time that the 
“zeroing” occurred. 


The rest of the screen is dedicated to the bar graph. Note that 
the packets-per-second meter can be toggled, as discussed 
above, from a linear to a logarithmic scale. The linear scale is 
used in Figure 5-3. The logarithmic scale is shown next. 
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Figure 5-4 


Matrix Screen 
(Logarithmic Scale) 





COUNT -- Network Performance Monitor i Version 4.0b 
Copyright 1984 Nestar Systems, Inc. PLAN Server (TM) software 
SKYLINE GRAPH OF PACKETS TRANSMITTED EVERY SECOND 
| | 
900+ +900 
l l 
| | 
700+ +700 
| | 
| | 
500+ +500 
| | 
| | 
300+ +300 
| | 

l { 
100 100 
o | 0 
SECONDS AGO: 60 50 40 30 20 10 0 


TOKEN TRANSIT TIME IN + aaa 





Press: Locate) Meter log -> lin) Zero) Skyline) Token) Quit) 


5-20 


NEST 


5.4 The NEST Utility 


The NEST utility allows the user to direct file server response 
codes to the DOS condition ERRORLEVEL instead of to the 
workstation console screen. NEST is normally for use in .BAT 
files, but since NEST is a much smaller program than NET, it 
can be used to quickly issue one network command.. 


Syntax (a line in a .BAT file): 

NEST <network command:: 
The network command is sent to the file server in the usual 
way, but instead of displaying the file server response on the 
screen, NEST sets the DOS condition ERRORLEVEL to the 
response code. 
For example, the line 

NEST MOUNT //USERS/EXAMPLE,D:,RW 
in a .BAT file causes the file server to attempt to mount the 
volume EXAMPLE at startup, and to return a response code to 
the workstation. 
If the mount is completed successfully, ERRORLEVEL is set to 
0. If the response code is, for example, 31 (for IN USE), 
ERRORLEVEL is set to 31. 


Applications: 


The DOS IF command allows you to jump to a different location 
in your .BAT file. For example, the line 


IF ERRORLEVEL 31 GOTO <label> 
following the NEST MOUNT command above would cause DOS 


to jump to <label> in your .BAT file whenever the volume 
//USERS/EXAMPLE is found to be in use. 
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In the same way. NEST can be used to find out, for example, 
if a volume is mounted on a drive: 
NEST REMOUNT D: 
what kind of volume is mounted: 
NEST SHOW TYPE D: 
if a user is already on the system: 
NEST LOCK USER.NAME,EXC 
if a volume exists: 
NEST LIST <pathname-- 
Note: NEST issues only file sever commands. Attempts to 
issue local commands such as INIT or SHOW DRIVES result in 


a non-zero ERRORLEVEL and the desired actions are not exe- 
cuted. 
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5.5 NWCMDS (Network Commands) 


NWCMDS allows access to the network from within any pro- 
gram environment. 


By simply striking a designated trigger character, <Ctrl> F, 
unless otherwise specified, your running program will be 
suspended and a scrolling window that can move to any position 
on the screen will appear. The window allows you to send com- 
mands to a file server or a virtual printer. Your commands and 
the server responses appear in the window. When your com- 
mands have been successfully executed, close the window. The 
window then disappears and the running program resumes. 


5.5.1 Installing NWCMDS 


NWCMDS.COM is distributed on the shared library volume 
/MAIN/LIB/IBMPC/DOS. 


NWCMDS can be installed manually or automatically. 
For manual installation of NWCMDS access the Nestar Main 
Menu and select the "File Server Commands" option. From the 


subsequent menu, select the “Install NWCMDS" option. 


NWCMDS needs to be manually installed each time your 
machine is rebooted. 


For automatic installation, simply include the command 
L:NWCMDS 

plus any optional installation parameters (see Section 5.5.1.2) in 

your AUTOEXEC.BAT file. "L:" in the above command should 

be included only if the DOS command PATH has not been set 


to include drive L:. 


The AUTOEXEC.BAT file exists on whatever drive your work 
volume is mounted on: 
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(1) Drive A: or C: if your profile mounts the library volume on 
drive L: and boots your work volume on drives A: or C:. 


>BOOT DOS3.0 ON C: 

MOUNT ;MAIN/USERS/CRAIG:DOS3.0,C:,RW 
MOUNT .MAIN/LIB/IBMPC;DOS.,L: 

BOOT C: 


(2) Drive E: if your profile boots the library volume on drive C: 
and mounts your work volume on drive E:, DOS will look for 
the AUTOEXEC.BAT file on drive E:. 


>BOOT DOS LIBRARY VOLUME 

MOUNT .MAIN, USERS/CRAIG/DOS3.0,E:,RW 
MOUNT .MAIN/LIB,IBMPC/DOS,C: 

BOOT C: 


Each time you reboot your machine and execute your profile 
NWCMDS is automatically installed. 


When invoked for installation, NWCMDS transiently requires 
approximately 50K bytes NWCMDS actually consists of approx- 
imately 5K bytes of code plus whatever space is necessary to 
save the pages of the screen window. If defaults for all parame- 
ters are used, NWCMDS requires approximately 11K bytes of 
space after it has been installed. 


5.5.1.1 /MAIN/SYSTEM/NAME Volume 
NWCMDS can be made to understand symbolic names as well 
as the address of file servers on the network; so when you want 
to direct a command to a particular file server, you simply 
preceed the command with "(a and the file server name. For 
example, 

(«BUTLER MOUNT MAIN. USERS:CMS. WORK,RW,Z: 
(Also, see Section 5.5.2.1.) 


During installation, NWCMDS looks on the default file server for 
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a shared Type=T volume called ;/SYSTEM NAMES. it this 
volume is not found, you can use NWCMDS to refer to various 
file servers by station address but not by name. 


If this volume is found, it is mounted and read (using an avail- 
able virtual drive) and the names are stored within NWCMDS. 


If the volume is not found, you may create a file at your works- 
tation defining the station addresses and names of ail file 
servers. For example, 


FS, STATION=$FE, NAME =BUTLER;: 
and TCOPY the file to the volume :/SYSTEM/NAMES. 


NWCMDS takes the station addresses and names of the file 
servers from //SYSTEM/NAMES. 


5.5.1.2 Optional Installation Parameters 


Several optional parameters can be specified wnen NWCMDS is 
installed. These parameters can appear in any order in the 
NWCMDS command line and should be separated from each 
other and "NWCMDS" by one or more spaces. Upper and lower 
case letters are equivalent. Numerical values can be specified in 
decimal, or in hexadecimal if preceded by a dollar sign ($). 


KEY n 


The trigger character is used to invoke the NWCMDS program, 
and this parameter sets the character to be an ASCII character 
who value is the number n between @ and 127. 


To use the trigger character, select an obscure control character 
or special graphic, rather than commonly used letters or 
numbers . The character selected as the trigger character can- 
not be used for any purpose other than to open and close the 
NWCMDS window. For instance, if you attempt to enter that 
character as input to a running application program, it will invoke 
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the NWCMDS window instead 
For example, the command 

NWCMDS KEY 7 
will change the trigger character from the default <Ctrl> F to 
<Ctri— G. 
KEY On 
This parameter sets the trigger character to be a non-ASCII 
extended function key. "n" can represent a number between 0 
and 255 as documented in the IBM PC Technical Reference in 
the "Keyboard Extended Functions" table. 
For example, specifying 


NWCMDS KEY 0 104 


will change the trigger character to <Alt> F1. 


KEY Fn 


This parameter sets the trigger character to be one of the ten 
function keys. "n" can represent a number between 1 and 10. 


For example, the command 
NWCMDS KEY F8 


changes the trigger character to the F8 function key. 


WINDOW row1 col1 row2 col2 
This parameter specifies the size and position of the network 


command window on the screen. “Row1, col1" indicates the top 
left corner of the window and “row2, col2” indicates the bottom 
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right corner. Both corners are relative to (1,1) as the upper left 
corner of the screen. Row numbers can range from 1 to 25 and 
column numbers from 1 to 80. The window must be contained 
entirely on the screen and be at least four columns wide and 
four rows high (although a larger size screen is more workable) 


The default window position is “WINDOW 4 31 19 76", which 
makes the window take about one quarter of the screen posi- 
tioned near the upper right corner. 


The WINDOW parameter specifies only the initial position of the 
window. When the window is displayed, it can be moved to any 
position on the screen by pressing <Shift> and one of the 
arrow keys. 

COLOR c 

This parameter sets the foreground and background colors if a 
color graphics monitor is being used. "c" represents values from 
@ to 255. See the /BM Technical Reference for the colors asso- 


ciated with each value. 


Depending on the display hardware, some values in the range 
of @ to 255 can result in the window being invisible. 


The default is "COLOR 7" which produces white characters on a 
black background for both the monochrome and color displays. 


For example, specifying 
NWCMDS COLOR $ie 


would produce a display of yellow letters on a blue background. 


PAGES n 
This parameter controls the number of pages of scrolled infor- 


mation that are saved. “n” can be a number from 1 to 10. The 
default is 4. This value affects the amount of memory space 
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taken by the NWCMDS program in addition to the amount of old 
information stored. 


ANOTHER 


It's possible to install multiple copies of NWCMDS to have multi- 
ple windows, and this parameter allows installation of an addi- 
tional copy of NWCMDS. An attempt to install another copy 
without the ANOTHER parameter will result in an error mes- 
sage. For each additional copy of NWCMDS you wish to install, 
include an additional NWCMDS command line with ANOTHER, 
KEY and WINDOW parameters in your AUTOEXEC.BAT file. 
To avoid confusion, each NWCMDS window should have a dif- 
ferent trigger character and window position.) For example, 


NWCMDS 
NWCMDS ANOTHER KEY 7 WINDOW 5 32 20 77 


in your AUTOEXEC.BAT file will install two NWCMDS windows. 
The first window will use all default values, while the second 
window will have the trigger character <Ctrl> G and a slightly 
different window position. 
5.5.1.3 Installation Error Messages 
After Autoexec.BAT is edited, reboot the system to install 
NWCMDS. Once successfully installed, the following message 
will be displayed: 

NWCMDS VERSION X.XX INSTALLED. 
However, if NWCMDS cannot be installed, one of the following 
error messages will be displayed: 
NWCMDS: Already installed 
A copy of NWCMDS is already installed, and the command line 
did not include the ANOTHER parameter. 
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NWCMDS: Unrecognized operand 

A keyword parameter is missing or incorrectly spelled, or extra 
unrecognized characters are in the command line. 

NWCMDS: Bad trigger character 

The value following the KEY parameter is not in the form of “n”, 
"Qn", or "Fn". Or, the numeric value of "n" and “O n" is not in the 
range of 0 to 255, or the value of "Fn" is not a number froin 1 to 
10. 

NWCMDS: Bad window specification 

The parameter WINDOW is not followed by 4 numbers, or the 
numbers are out of range, or the first corner is not above and to 
the left of the second corner, or the window is too small, too 
large, or off the screen. 

NWCMNDS: Bad color specification 

The COLOR parameter is not followed by a number value, or 
the number is not in the range of @ to 255. 

NWCMDS: Bad number of pages 

The PAGES parameter is not followed by a numerical value, or 
the number is not in the range of 1 to 8. 

NWCMDS: L4 locate error 

The network transport driver is not installed. Check the 


CONFIG.SYS file on your boot volume to see that it includes the 
network device. 
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NWCMDS: NCMD driver not found 


The virtual command driver cannot be found. Check the 
CONFIG.SYS file on your boot volume to ensure that it includes 
the network device. 


NWCMDS: LPT3 driver not found 


The virtual print driver cannot be found. Check the 
CONFIG.SYS file of your boot volume to make sure it includes 
the network device. 


Error reading //SYSTEM/NAMES file 


This message indicates that an error was encountered when try- 
ing the read the //SYSTEM/NAMES volume to determine file 
server names. Either the volume doesn't exist on the default 
server, or it cannot be mounted for read access, or it is not in 
the proper format. NWCMDS will complete the installation, but it 
will not allow for symbolic file server addressing. 


5.5.2 Using NWCMDS 


To invoke NWCMDS, simply press the designated trigger char- 
acter. The default is <Ctrl> F. Your running program will be 
suspended and the NWCMDS window will appear. See Figure 
5-5. 


Once the window is open, commands can be sent to any file 
server or a virtual printer. 


Note that <Ctrl><PrtSc:- (toggle printer mode) does not work 
from within the NWCMDS window. However, <Shift><PrtSc> 
(print screen) and <Alt.- 222 (end print job) do work. For details 
on activating screen dumps on the numeric keyboard, see Sec- 
tion 3.2.1. 


5-30 


NWCMDS 


Figure 5-5 


NWCMDS Window 


Lines which scroll out of the top of the window are saved in 
pages which can be viewed by using the <PgUp>, 
<PgDn>,<Home>, and <End>' keys. The most recently 
issued commands and responses will appear at the bottom of 
the last page, which can be reached by striking the <End> key. 
Up to 8 pages of scrolled material can be saved. See Section 
5.5.1.2. 


The NWCMDS window can be moved to any position on the 
screen by pressing <shift> and the appropriate <arrow> key. 
The window will stay in this position until moved again or until 
NWCMDS is re-installed wherein the window will take the 
default position or the position defined in the "WINDOW" param- 
eter. 


NWCMDS supports the same function key editing provided for 


DOS commands. For more details, see the IBM DOS Version 
3.10 Reference. 
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To close the NWCMDS window, press the trigger character or 
enter "Q" (upper or lower case accepted) and press <Return =. 


5.5.2.1 File Server Commands 


Once the NWCMDS window is open, commands to the default 
file server can be issued. For example, during an editing ses- 
sion, you wish to mount a new volume on which to write the 
edited file to. Simply type in the command: 


MOUNT “USERS/LJS/TIMING,G:,UPD 
The network prompt (:) appears if the command has been suc- 
cessfully executed. Otherwise, you will receive an error mes- 


sage. 


Once the file server has executed your command, press “Q" 
and <CR> to close the window. 


To issue commands to other file servers, use the command 
(@NAME 

where "NAME" is the name of a file server defined in the 

Type=T volume //SYSTEM;NAMES. For more details, see 

Section 5.5.1.1. 


NWCMDS will not accept local NET commands (including INIT) 
(see Section 2.6). 


NWCMDS will accept all of the file server commands as well as 
the local commands starting with «c, ?, or !. 


When invoking NWCMDS while running an application pro- 
gram, avoid changing default file servers or unmounting 
volumes being written to or containing the application pro- 
gram itself. 
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5.5.2.2 VPCMDS (Virtual Printer Commands) 


VPCMDS allows access to the virtual printer from within any 
program environment. 


By striking a designated trigger character, <CNTRL>F unless 
otherwise specified, your running program will be suspended 
and a scrolling window will appear. Within the window, the 
prompt VPRINT: indicates that you may type a command line to 
be sent to the network virtual printer; the command is automati- 
cally preceeded by the escape sequence <ESC> V. See 
Chapter 3 for more on sending information to the virtua! printer. 


For example, you may need to change the priority for your next 
virtual print job. Press the VPCMDS _ trigger 
character, <CNTRL>F, and the VPCMDS window will be 
displayed with the VPRINT+ prompt. Then type “priority:high” 
<CR> to cause that line to be store in the virtual printer 
header. Then press <CNTRL>F again to close the VCPCDS 
window. The next virtual print job will then be submitted as a 
high priority job. 


Or, if you wish to reset the header, simply type “.R” when the 
VPRINT: prompt is displayed. Remember that "<ESC>V" has 
been automatically prepended to your command. 


VPCMDS contains a subset of the functions of NWCMDS and is 
useful in a controlled environment where access to network 
fileserver commands is to be restricted. The installation instruc- 
tions and error messages for NWCMDS apply also to VPCMDS 
with the exception that the system names file 
SYSTEM/NAMES is not required or used by VPCMDS. See 
Section for installation instructions. 


For information on sending to the virtual printer using VPCMD, 
see Section 
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5.6 CARDCHK 


CARDCHK is designed to test IBM Network Interface Cards 
(NICs) in all allowable configurations. It consists of various dif- 
ferent test routines. each test being selectable so that any parts 
not present on any given NIC can be ignored. The section 
assumes that the user is familiar with the theory of operation of 
the NIC as described in Chapter 2 of the PLAN Series 
CARDCHK Utility Program and NIC Theory of Operations for 
the IBM PC Manual. Chapter 2 includes a functional descrip- 
tion, circuit diagrams, and decoder PROM listings. 


The utility, as supplied, contains all the software that is required 
to test a NIC, although two machines are required to run a com- 
plete NIC test. The first machine contains the NIC under test, 
running the test options. The second machine (containing a 
known good NIC) runs a program option called the ECHO 
SERVER. The two machines’ NICs are connected by a length of 
standard coax cable (RG62). The ECHO SERVER ıs used to 
test a NIC’s ability to talk to another station over the network 
link. The host machines running the test software can be any 
combination of IBM personal computers. (The two machines can 
be part of an active network, but this is not recommended.) 


The software is designed to be “user friendly”, leading the user 
through the required setup parameters and giving helpful error 
messages to use when debugging a board fault. Additional 
information on error message fault indications is provided in 
Section 5.6.3. 


The CARDCHK program is designed to test one NIC at one 
time. Should more than one card be inserted in a machine, the 
results are unpredictible. 


5.6.1 Running the Program 
To begin, make sure that the two machines to be used in the 
testing are configured correctly. Both machines need 128 kbytes 


of RAM. The machine that is to be the ECHO SERVER must 
have a known good NIC with its station address set to be 
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different from ANY that will be used in the NIC under test. The 
NIC in the ECHO SERVER can be attached to a standard 
BNC.BNC cable, but for exhaustive testing should be attached 
to a length of cable that has an attenuator (180 ohm resistor) in 
series with it, or a 4 port passive HUB connected in series with 
it (to check the threshold levels of the driver/receiver circuitry 
during testing). Insert the NIC to be tested in the machine used 
to test the NICs and connect the NIC to the other side of the 
attenuator or passive HUB via coax cable. 


The two machines can be part of an active network, but it is not 
recommended. Certain CARDCHK tests will cause excessive 
reconfigurations, which may disrupt the network. In addition, 
problems in intervening hubs and cabling may confuse test 
results. (On the other hand, if CARDCHK runs without errors on 
a station that is part of a network, there is no such confusion. 
Some system managers may find it most convenient to use two 
stations on the network, isolating the machines only if errors are 
encountered.) 


To run the software, type "L:CARDCHK" (assuming that the 
shared DOS library volume is mounted on drive L:) 


a. boot DOS 2.0 or higher, 

b. insert the floppy containing CARDCHK, 

c. log on to that drive 

d. type CARDCHK (Return) 
The program will search for an NIC residing in the machine. If 
no card is found (either being absent, incorrectly addressed in 
the memory map, or faulty), an error message will be displayed 
and the program can be aborted, allowing the error to be 
corrected, or permitted to continue assuming the default value 
base address ($D200). This procedure allows the user to test a 


board with a defective ROM in it. 


The test menu gives the user the opportunity to select the 
ECHO SERVER option or any combination of the eight test 
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options. Turn one of the test machines into an ECHO SERVER 
by selecting option 9. 


The ECHO SERVER allows you to confirm that the station to be 
checked and the known good station are communicating with 
each other. Selecting the ECHO SERVER will cause a matrix to 
be displayed: 


ECHO SERVER: Press any key to return to main menu. 


Second Digit 
0123456789 ABCDEF 
0 0 0 
1 1 1 

F 2 2 2 
i 3 3 3 
r 4 4 4 
s 5 5 5 
t 6 6 6 
7 7 7 
d 8 8 8 
i 9* 9 9 
g A A A 
i B B B 
t C C* C 
D D D 
E E E 
F F F 
0123456789 ABCDEF 


The matrix will show which stations are sending packets to be 
echoed. A non-blank cell shows that some packets have been 
echoed. A cell that is changing shows ongoing activity. Station 
$FO is in the lower left corner, $0F is in the upper right. The 
screen above shows that stations $90 and $C8 are active. 


The test options selected will depend to some extent on the type 
of card being tested and on the degree of testing required. For 
PLAN 2000 NICs, the USER RAM and the PIT (Programmable 
Interval Timer) may have been removed, so these options 
become obsolete (i.e., if selected the tests will fail). Pressing a 
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test option number toggles the selection of that test, enabling 
the operator to deselect as well as select tests. 


Option 8 allows the degree of testing to be selected: a single 
pass through the tests, testing until an error is detected, con- 
tinuous testing or testing for 100 cycles. After the options have 
been chosen, testing can be started by pressing "T”. 


While executing the test routines, the program displays the total 
passes through the test cycles and the number of errors it has 
encountered on each test. The testing can be stopped at the 
end of a cycle, or on encountering any error, by pressing the 
indicated keys. Once stopped the error counters is left on the 
screen until the space bar is depressed, at which time a sum- 
mary of any errors found is displayed. This summary gives infor- 
mation helpful in tracking down a fault in a NIC. (For details of 
the error messages, see Section 5.6.3.) 


From the error summary, the operator can resume testing or 
return to the test menu to exit the program. 


5.6.2 Descriptions of Tests 


The different functions of the tests used by the CARDCHK pro- 
gram are described below. The program displays a descriptive 
error message to the user. It should be noted that within many 
of the test routines the first error detected will cause that test to 
abort. Thus the error returned may not be a comprehensive list 
of the failures within every routine. 


Interface ROM tests 


This routine ORs the first 32 values in the ROM to give an 
expected value of FF(hex), then ANDs 32 values with 
FF(hex) to give an expected value of @ Any deviation from 
these values indicates that some data line was “stuck” at 
some logic level (1 or @) and gives rise to an error indica- 
tion. 


This routine adds all the locations in the ROM (carry 
ignored) to give a checksum value. The addition is done on 
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an 8 bit basis, all present (at or after UIO). ROMs have a 
checksum of zero. Ethernet address and interrupt level are 
displayed. 


RIM RAM buffer test 


The 2 kbyte memory area is tested by a full walking 1's 
test, which checks for "bit" sensitivity within the RAM chip. 
The RAM is then written throughout by a non-repeating 
sequence to check for page sensitivity. 


User RAM test 


The 2 kbyte (less 8 bytes) of user RAM is tested in the 
same manner as the RIM RAM above. 


RIM test 


This test exercises the RIM-to-host interface, together with 
the RIM's RAM access. The RIM is put into a Power On 
Reset (POR) condition, then released. The diagnostic value 
D1(hex) is checked for in the RIM RAM address 0. Failure 
by the RIM to do this within a few microseconds produces 
an error. The station address then is checked to be non- 
zero (zero being invalid); if zero, an error is returned. The 5 
high order bits of the IRQ level register are checked to be 
zero, an error resulting if not. The setting of the RIM inter- 
rupt line (internal to the NIC, not at the host) by the various 
internal RIM flags is then checked by unmasking the POR, 
RI, TA and RECON flags in turn. Failures here produce 
errors. If no tests fail, the station address is displayed 


Programmable Interval Timer test 


This test is disabled as a default, since the standard NIC 
does not have the PIT installed. 


This routine sets counter O to give a basic 250 microsecond 
clock as an input for counters 1 and 2, then loads counter 1 
to timeout in 5 sec. The start and end time is noted from 
the internal DOS timer (18.2 ticks a second), and the 
elapsed time is returned to the host program. Counter 2 is 
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then given the same treatment, and the program then cal- 
culates if the elapsed times are within the allowable specifi- 
cation. 


Network Access test 


After reinitializing the interface card, this test causes a 
broadcast message to be sent over the network connection. 
This is echoed back to the NIC by any ECHO SERVER 
present on the network. If no reply is heard within the 
preset timeout, an error is indicated (note that this could be 
a result of a card failure OR simply because no echo server 
was connected). Having discovered a working ECHO 
SERVER, the program knows the station address of the 
ECHO SERVER and then sends packets from each of the 
available RIM buffers in turn, which are received into dif- 
ferent buffers such that all four buffers both transmit and 
receive. The program returns an error if the transmission 
from the NIC was not acknowledged by the ECHO 
SERVER (TMA), an error if no return message was 
received back from the ECHO SERVER, and an error if the 
data received from the ECHO SERVER was not that which 
was sent (determined by a comparison of the transmit and 
receive buffers data). 


Interrupt test 
This routine causes interrupts to be set by the RIM chip and 


then each of the PIT counters in turn. Possible errors are 
failures in the RIM and PIT counters 1 and 2 interrupt logic. 
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5.6.3 Error Messages and Their Interpretation 


The information given in this section expands and explains the 
error messages given by the test program in the final error sum- 
mary. These are only intended as a guide to the probable fault 
causing the error message to be generated. However, their 
accuracy Cannot be guaranteed, since some faults may show up 
in unexpected ways because of the interdependence of many of 
the boards functional elements. For example, the two separate 
data buses present on the card (the NIC and RIM data buses) 
are separately buffered but connected during some operations 
of the board. 


Often the best clue to any particular fault will be the combination 
of errors indicated by the test program. It should also be noted 
that faults in the PCB tracking or defective solder joints, etc., 
may be heavily disguised within the error indications. 
ROM TEST ERRORS 
DATA LINE TIED LOW 
In ORing the data read from the ROM, the result was not 
FF (hex), i.e., at least 1 data line was stuck at logic 0. 
Faulty ROM (IC22), NIC data bus, address bus or decode. 
DATA LINE TIED HIGH 
In ANDing the data read from the ROM, the result was not 
0, i.e., at least 1 data line was stuck at logic 1. Faulty ROM 
(1C22), NIC data bus, address bus or decode. 
UNEXPECTED CHECKSUM 
The 16 bit checksum obtained from the ROM does not 


match any of the known ROM version checksums. Faulty 
ROM (IC22), NIC data bus, address bus or decode. 
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RIM RAM TEST ERRORS 
BUFFER RAM WALKING 1 S FAILURE 
During the write/read cycle of the walking 1 test, data writ- 
ten to the RAM was not read back the same. Faulty RAM 
(1C21), data buses or decode. 
BUFFER RAM SERIES R/W FAILURE 
In reading back the non repeating series written to the 
RAM, a data mismatch was located. Faulty RAM (IC21), 
address bus or decode. 

USER RAM TEST ERRORS 
USER RAM WALKING 1 S FAILURE 
During the write/read cycle of the walking 1 test, data writ- 
ten to the RAM was not read back the same. Faulty RAM 
(1023), NIC data bus or decode. 
USER RAM SERIES R/W FAILURE 
In reading back the non repeating series written to the 
RAM, a data mismatch was located. Faulty RAM (IC23), 
address bus or decode. 

RIM TEST ERRORS 
RIM SELF TEST ERROR 
After strobing the POR line on the RIM chip, the self test 


value read from the RIM RAM was not D1 (hex) as 
expected. Faulty RIM (IC28), RIM data bus or decode. 
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ILLEGAL OR NON CONSTANT STATION ADDRESS 


The station address read from the RIM RAM after the RIM 
POR was either illegal (0) or changed during the period of 
the test. Faulty RIM (IC28), 1C30, Clock circuit (Xtal or 
1C29) or decode. 


POR FLAG NOT SETTING INTERRUPT STATUS 
Unmasking the POR flag in the RIM status register, when 
set, did not cause the RIM interrupt bit to be set in the NIC 
status byte. Faulty RIM (IC28), |C14, data buses or decode 
CLEAR POR NOT CLEARED INTERRUPT STATUS 

The Clear POR Flag command to the RIM did not cause 
the RIM interrupt bit in the NIC status byte to be cleared 
Faulty |C14, RIM (IC28), data buses or decode. 

TA FLAG NOT SETTING INTERRUPT STATUS 

Unmasking the TA bit in the RIM status register, when set, 
did not cause the RIM interrupt bit to be set in the NIC 
status byte. Faulty RIM (IC28), |1C14, data buses or decode. 
RI FLAG NOT SETTING INTERRUPT STATUS 

Unmasking the RI bit in the RIM status register, when set, 
did not cause the RIM interrupt bit to be set in the NIC 
status byte. Faulty RIM (IC28), IC14, data buses or decode. 
RECON FLAG NOT SETTING INTERRUPT STATUS 
Unmasking the RECON bit in the RIM status register, when 


set, did not cause the RIM interrupt bit to be set in the NIC 
status byte. Faulty RIM (IC28), |C14, data buses or decode. 


HIGH BITS OF IRQ INDICATOR NON ZERO 


Top 5 bits of IRQ level were read as being non zero, which 
is the hard wired option. Faulty IC20, NIC data bus or 
decode. 


PIT TEST ERRORS 
PIT COUNTER 1 SLOW (see ~ below) 


The number of DOS timer ticks returned indicated that the 
PIT counter 1 did not time out when expected, there being 
too many ticks registered during the PIT timeout. Faulty PIT 
(1C24), Clock circuit (Xtal, IC29 or IC8), NIC data bus or 
decode. 


PIT COUNTER 1 FAST (see * below) 


The number of DOS timer ticks returned indicated that the 
PIT counter 1 did not time out when expected, there being 
too few ticks registered during the PIT timeout. Faulty PIT 
(1024), Clock circuit (Xtal, IC29 or IC8), NIC data bus or 
decode. 


PIT COUNTER 2 SLOW (see * below) 


The number of DOS timer ticks returned indicated that the 
PIT counter 2 did not time out when expected, there being 
too many ticks registered during the PIT timeout. Faulty PIT 
(1024), Clock circuit (Xtal, IC29 or IC8), NIC data bus or 
decode. 


PIT COUNTER 2 FAST (see * below) 
The number of DOS timer ticks returned indicated that the 


PIT counter 2 did not time out when expected, there being 
too few ticks registered during the PIT timeout. Faulty PIT 
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(IC24), Clock circuit (Xtal, IC29 or IC8), NIC data bus or 
decode. 


PIT COUNTER 1.2 IRRATIC 


In the special case where the PIT test returns a wildly vary- 
ing number of DOS ticks, the test program prints the mes- 
sage PIT COUNTER x IRRATIC. Here, a combination of 
the SLOW and FAST symptoms occur. 


INTERRUPT TEST ERRORS 


5-44 


RIM INTERRUPT NOT SEEN BY HOST 


Setting test bit in the RIM, then enabling onto host interrupt 
line, did not cause an interrupt to be seen by the host pro- 
cessor. Faulty RIM (1C28), 1C19, IC9, IC5, IC7 or decode 


COUNTER 1 INT. NOT SEEN BY HOST 


Setting PIT counter 1 output high, then enabling onto host 
interrupt, line did not cause an interrupt to be seen by the 
host processor. Faulty PIT (1C24), 1C19, IC10, IC5 or 
decode. 


COUNTER 2 INT. NOT SEEN BY HOST 


Setting PIT counter 2 output high, then enabling onto host 
interrupt line, did not cause an interrupt to be seen by the 
host processor. Faulty PIT (IC24), 1C19, 1C10, IC5 or 
decode. 


NE TEST ERRORS 
COULD NOT SEND TO ECHO SERVER (NO TA) 


Broadcast or transmitted data packet not responded to by 
ECHO SERVER. This can be a fault on the interface card, 
faulty hybrid, IC29, RIM (IC28), or ECHO SERVER itself 
may be at fault or not connected. 


RECEIVED NO ACKNOWLEDGE FROM ECHO SERVER 


Data packet sent to the ECHO SERVER was not ack- 
nowledged by server. This can be a fault on the NIC, faulty 
hybrid, IC29, RIM (1C28), or a network or ECHO SERVER 
fault (if the fault is consistant, the ECHO SERVER is prob. 
ably at fault). 


DID NOT RECIEVE ECHO FROM SERVER 


The station address of an ECHO SERVER having been 
established and a data packet acknowledged by the server, 
no frame was received back from the ECHO SERVER. This 
is probably an ECHO SERVER or Network error (interfer- 
ence), though it could be indicative of a hybrid, RIM (IC28) 
or IC29 fault. 


DATA RECEIVED DOES NOT MATCH DATA SENT 
The received packet from the ECHO SERVER, once in the 


RIM buffer, contained data not consistent with that sent. 
Faulty hybrid, RIM (IC28), IC29, IC16 or IC21. 


COULD NOT LOCATE ECHO SERVER USING BROAD- 
CAST 

The initial attempt to discover a PC running the ECHO 
SERVER mode of CARDCHK failed. Check that an echo 


5-45 


server is active on the Network. 


TOO MANY RECONS OCCURING TO CONDUCT TEST 


The RIM chip is seeing too many network reconfigurations 
for the Net test to produce reliable results. Check that the 
NIC is connected to the network (the green light should be 
on). Locate the source of reconfigurations on the network. 


Note: In the Net test errors, the correct interpretation of errors 
needs to be considered with regard to the environment, as the 
errors could be caused by faults in the external world, i.e., the 
ECHO SERVER and Network link. 


References to LAND in 23 - 26 refer to the hybrid filter located 
adjacent to the BNC connector. 
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Chapter 6 


Applications on the Network 


6.0 introduction 


This chapter contains the following information: 


Selecting an Application Section 6.1 
Trying Out the Applications Section 6.2 
Saving and Printing Data from Applications Section 6.3 
Mounting Data Volumes at Startup Section 6.4 
Adding an Application to the Menu Section 6.5 
How the Networked Applications Run Section 6.6 
LAN:MAIL MONITOR Section 6.7 


6.1 Selecting an Application 


Nestar distributes the PLANPak II™ application starter library 
with its PLAN Series software. With PLANPak II, you can use 
business application programs in a network environment as 
soon as you turn on your workstation. 


The distributed application programs include SuperCalc3, Super- 
Writer, DATASTORE:LAN and LAN:MAIL MONITOR (PLANPak 
ll requires a computer with 256K of memory to run LAN:MAIL 
MONITOR and a computer with 320K of memory to run 
DATASTORE:LAN). You can also install up to ten additional 
application programs. (See Section 6.5.) 


SuperCalc3 and SuperWriter are licensed to be used con- 
currently by no more than 4 persons. Additional concurrent 
users can be authorized with an additional license fee. 


DATASTORE:LAN and LAN:MAIL MONITOR can be used con- 
currently by an unlimited number of persons. However, only 5 
people are able to share the same DATASTORE:LAN database 
(file) concurrently. An upgrade is available for 
DATASTORE:LAN which permits up to 12 concurrent users of a 
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single database. 


Your application program can be accessed from the menus at 
startup time or from within the DOS environment. To access the 
main menu at startup, power-on your machine. If the main menu 
does not appear, ask your system manager how to reach it. 


To reach the application menu from DOS, type “menu as 
shown below: 


C> MENU <RETURN> 


(assuming the DOS library volume is mounted on drive C | If the 
library volume is mounted on drive L:, type "L:MENU". Other- 
wise, ask your system manager how to reach the menu.) See 
Figure 6-1. In the following figure, SuperCalc3 is used as the 
sample application program. 


6.2 Trying Out the Application Programs 


To try out the PLANPak programs (without saving any data), 
simply select the application program of your choice from the 
applications menu. 


To try out the programs AND save data from them onto a sam- 
ple data volume, begin by selecting the "Demonstration with 
sample work data” option from the main menu A subsequent 
menu will allow you to select a data volume. You can also save 
data onto your personal DOS work volume, if it is mounted 
Read/Write (see Section 6.3). 


The applications menu will also offer a "Utility Programs’ 
option. Selecting the utility option will cause a menu of Nestar 
utility programs such as NET, COUNT, and TCOPY, to be 
displayed. See Chapter 5 for more on these utilities. 


Exiting from an application program will return you to the appli- 


cation menu. You can then select another of the PLANPak pro- 
grams, or return to the main menu. 
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Figure 6-1 


Accessing Your Application Programs 


at startup time from DOS 








power on 
your machine 


type “menu” 


select 
“applications” 


APPLICATIONS MENU 


select 
SuperCalc3 






exit 
SuperCalc3 
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6.3 Saving and Printing Data from Application Programs 


To save data from an application program, the data must be 
written to a file on a DOS virtual volume which is mounted 
Read/Write. 


PLANPak II takes drive E: as the default drive for a data 
volume. Drives F: and G: are used by the application program 
volumes themselves. Drives H: through Z: are also available for 
data volumes, although some application programs limit the 
drives that can be used. The application program SuperWriter 
requires that data volumes be mounted on drive H: or lower. For 
application programs that do not limit the drives that can be 
used, MOUNT commands can be included for drives H: through 
Z:. 


You can use a sample data volume, as described in Section 6.2, 
or do one of the following: 


(1) Mount a volume manually at startup: Select "File Server 
commands” from the main menu. Select "Issue file server 
commands” from the subsequent menu, and issue a 
MOUNT command such as: 


MOUNT pathname, RW,E: 


where pathname is the network pathname of the DOS vir- 
tual volume to be used. Type "Q" to return to the file 
server command menu and then press <Esc> to return to 
the main menu. 


Then press the “Applications” option. 


(2) Mount a volume automatically at startup: Either you or 
your system manager can customize your station profile to 
mount data volumes automatically at startup. See Sections 
1.3, 1.4 and 6.4 for more information. 


(3) Mount a volume manually from DOS: If you are accessing 
the applications menu from DOS by typing “menu”, mount 
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your data volume first: 
C.» NET MOUNT pathname,RW,E: 


where pathname represents the pathname of your data 
volume. 


When you are ready to save data from an application program, 
specify the drive letter where your DOS virtual volume is 
mounted, then the filename that you want to save your data to 
For example: 


E: filename 
where filename represents the name of the data file. 
If you do not include the drive letter when specifying the 
filename, the application program will assume your file is 
on drive F:. Drive F:, however, is the drive upon which the 


application volume itself is mounted Read/Only. 


Always include the drive with the filename when specifying 
a filename in an application program. 


After using the print option in an application program, do not for- 
get to close the virtual printer by entering <Alt- 222 (hold down 
the <<Alt - key, and enter "222" from the numeric pad). 

6.3.1 Moving Files From DATASTORE:LAN to SuperCalc3 

A three-step process is used to move data from a 
DATASTORE:LAN file to a SuperCalc3 file. 

Step 1 Print the DATASTORE:LAN File 

When a database has been chosen, select the report option 


(F3) from the main menu of DATASTORE:LAN. Next, select the 
File (F) option. Provide the file name and the extension ".SD!" 
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(Super Data Interchange). Under Format, select "D" to queue 
the SDI format. Use the following as a guide: 


REPORT SPECIFICATIONS 


Printer, File or Display (P, F, D)? F 
File name? MYFILE.SDI 
Format (R N, A, B, M, W, D)? D 


Use the defaults for the remaining repor specifications. Next, 
select the desired fields and how the fields are to be ordered 
(i.e. Physical or Sorted). 


Step 2 Convert the File to SuperCalc3 


To convert the SDI format file to a SuperCalc3 file, use the 
Super Data Interchange program. This program resides on the 
SuperCalc3 volume under SDI.COM. 


The Super Data Interchange program will present a menu of 
available file conversions. Select "D” to convert an SDI-format 
file to a SuperCalc3 file. Next, provide the file name. Use the fol- 
lowing as a guide: 


These are the File Conversions Available: 


A. SuperCalc3 file to Comma Separated Value file 
B. Comma Separated Value file to SuperCalc3 file 
C. SuperCalc3 file to SuperData Format file 

D. SuperData Format file to SuperCalc3 file 

X. Exit program 


Enter Your choice (A, B, C, D, or X)? D 

File Name? MYFILE 
Note that when giving the file name, the extension ".SDI" is not 
specified. If files are named with any extension other than 


"SDI", give the full name including extension. The new Super- 
Calc3 file is created with the extension “.CAL”. Once the new 
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file is created, exit this program. 


Step 3 Load the SuperCalc3 File 

The new SuperCalc3 file is loaded like any normal SuperCalc3 
file. Since cell widths are not formatted, only the first ten charac 
ters are seen. 

This procedure moves information in only one direction. Data 
from a SuperCalc3 file cannot be moved into a 


DATASTORE:LAN file. Use DATASTORE:LAN to handle large 
databases and SuperCalc3 to graph the results. 


6.4 Mounting Data Volumes Automatically at Startup 


To provide a data volume automatically at startup for use with 
the application package: 


When No Personal Profile Exists For Your Station: 
Put the following in a standard DOS text file 


MOUNT pathname, E:,RW 
PROFILE MENU 


where “pathname” is the network pathname of your data 
volume. PLANPak takes drive E: as the default drive for a data 
volume. 
Next, TCOPY the file to the pathname 

i: SYSTEM. PROFILE: $NN 


where $NN is the hexadecimal address of the station to use the 
volume (see section 5.2 for more on TCOPY). 


Now, a small “profile” volume exists for your station. Each time 


you start up, the specified volumes will be mounted, and the 
menus specified in the “menu” profile will be displayed. 
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If a Personal Profile Already Exists for Your Station: 
Add the following lines to your profile: 


MOUNT pathname,E:,RW 
PROFILE MENU 


where pathname is the network pathname of your data volume. 


6.5 Adding An Application Program to the Menu 


To add a new application to the PLANPak applications menu, 
you must 


(1) create a profile called //SYSTEM/PROFILE/APPLUSER. 
(2) create an AUTOEXEC.BAT file on the application volume. 


Step 1 The APPL/USER Profile 


The APPL/USER profile must present options that, upon selec- 
tion, mount an application volume on drive F:, and boot drive C: 
from startup or drive F: from the DOS environment. For exam- 
ple: 


>RUN THE EASY APPLICATION 
MOUNT //APPLICATIONS/EASY,F: 
BOOT F: 

BOOT C: 

ECHO BOOT C: 


The three boot statements above make access possible from 
startup (discussed in Section 6.6.1) or from the DOS environ- 
ment (discussed in Section 6.6.2). 


The profile can be accessed by selecting “Other Installation 
Applications” from the Network Utility Program Menu. 
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Explanation (Step 1) 


If booting from the DOS environment, the BOOT F: statement is 
executed and the BOOT C: and ECHO BOOT C: statements are 
ignored. If booting from startup, the BOOT F: statement is 
ignored because DOS allows booting only from drives A: and C:. 
The BOOT C: statement is executed since the library volume is 
already mounted on drive C:. If problems arise when booting 
drive C:, the ECHO BOOT C: statement displays the error. 


If problems arise when booting drive C from a menu and the 
“ECHO BOOT C:" statement is not present, then no error mes- 
sage will be displayed and you will be returned to the menu. If 
the same situation occurs when entering the commands from 
the keyboard, then no error message will be displayed and the 
network prompt (:) will be returned. The responses discussed in 
this paragraph assume that only “BOOT F:" and "BOOT C:" 
statements exist. The responses may vary if additional state- 
ments are present. 


Step 2 AUTOEXEC on the Application Volume 


The application volume should contain a batch file called 
AUTOEXEC.BAT that contains the following: 


ECHO OFF 
EASY 
MENU APPL MENU 


Explanation (Step 2 


The ECHO OFF statement above allows chaining between 
application programs to be transparent (no DOS batch displays 
will appear on the screen). The EASY statement executes the 
application program EASY. After you have exited the application 
program, the MENU APPL’MENU statement returns control to 
MENU.BAT on the library volume which chains you back to the 
applications menu. 
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6.6 How the Networked Application Programs Run: A 
Technical Explanation 


There are two ways to access your application programs. The 
first method is at startup time (discussed in Section 6.6.1). The 
second method is from within the DOS environment (discussed 
in Section 6.6.2). Similarities and differences are visually 
presented in Figure 6-2. SuperCalc3 is used as the sample 
application program in the following text and figure. 


6.6.1 At Startup Time 


At power-on, the BOOT program presents the main menu. 
When the applications option is selected, the BOOT program 
mounts the DOS library volume on drive C: and drive L:, then 
chains to the APPLMENU profile. For each application pro- 
gram available, five lines like the following exist in the 
APPL:MENU profile volume: 


>SUPERCALC3 

MOUNT //APPLICATIONS/SUPERCALC3,F: 
BOOT F: 

BOOT C: 

ECHO BOOT C: 


Select the SuperCalc3 option, and BOOT executes the five lines 
in the APPL/MENU profile volume that relate to it. 


The BOOT F: statement is interpreted as an illegal statement 
(at startup, you can boot only from drive A: or drive C:). 
Next, the BOOT program boots the 


library volume on drive C:, and DOS runs the AUTOEXEC.BAT file on 


the library volume. AUTOEXEC.BAT on the library volume 

then chains to AUTOEXEC.BAT on the application volume. 

When the SuperCalc3 program is exited, AUTOEXEC.BAT on the 
application volume chains to MENU.BAT on the library volume. 
MENU.BAT again presents the applications menu. 


6-10 


APPLICATIONS 


6.6.2 From the DOS Environment 


To access the applications menu from within the DOS environ- 
ment, type “MENU”. This invokes MENU.BAT on the library 
volume. MENU.BAT displays the applications menu, then 
invokes the PROFILE program, which interprets the 
APPL, MENU profile. The profile contains the following five lines 
for each PLANPak I! application: 


>SUPERCALC3 

MOUNT », APPLICATIONS: SUPERCALC3,F: 
BOOT F: 

BOOT C: 

ECHO BOOT C: 


Selecting an application such as SuperCalc3 causes the PRO- 
FILE program to mount the application volume on drive F:. 
Next, the BOOT F: statement causes the PROFILE program to 
set the current drive to drive F: and exit. MENU.BAT then 
regains control and chains to AUTOEXEC.BAT on the applica- 
tion volume. When the SuperCalc3 program is exited, 
AUTOEXEC.BAT chains back to MENU.BAT. MENU.BAT again 
displays the applications menu. 


6.7 Using LAN:MAIL MONITOR 


To access the LAN:MAIL MONITOR menu, select the 
LAN:MAIL MONITOR option from the applications menu. You 
will be presented with five options: 


(1) Send or receive mail. 

(2) Run LAN:MAIL MONITOR manager (password and 
exclusive access required). 

(3) Prepare LAN:MAIL MONITOR to send or receive from 
remote sites. 

(4) Test the modem connection. 

(5) <Esc> which will return you to the applications menu. 


You will need to be familiar with the LAN:MAIL MONITOR 
manual. Keep the LAN:MAIL MONITOR manual handy for 
reference. 
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Figure 6-2 


How the Networked Application Programs Run: 


A Technical Explanation 


at startup time 


POWER ON YOUR 
MACHINE 







BOOT program 
interprets 
MENU profile 


TYPE “MENU” 


SELECT “APPLICATIONS” 










MENU.BAT on library 
volume executes and 
invokes PROFILE 
program 


PROFILE program 
interprets APPL/ 
MENU profile 


BOOT program mounts 
library volume on 
virtual drives 

C: and L: 


APPLICATIONS MENU 


SELECT SuperCalc3 


BOOT program mounts 
SuperCaic3 volume on 
F: and boots library 
volume on drive C: 
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SELECT SuperCalc3 


PROFILE program 
mounts SuperCalc3 
volume on drive F: 
and sets current 
drive to F: 


MENU.BAT chains to 
AUTOEXEC.BAT on 
SuperCalc3 volume 


EXIT SuperCalc3 


AUTOEXEC.BAT chains 
to MENU.BAT 
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6.7.1 Set Up and Maintenance 


Note: Refer to Chapter 3 ("The Mail Manager Program’) in the 
LAN:MAIL MONITOR manual. 


The “post office” file, called POST.MM, has already been 
created along with several sample user files which are described 
in the LAN:MAIL MONITOR manual. 


To set up and maintain the POST.MM file, select the “Run 
LAN:MAIL MONITOR manager" option from the LAN:MAIL 
MONITOR menu. You will be presented with a menu of options 
(display, list, add, remove, etc.). Follow the instructions in the 
LAN:MAIL MONITOR manual. 


When adding new users, note that the user's volume name 
should correspond to a drive letter (A: through Z:). The drive can 
be either a real drive such as a hard disk, or a virtual drive. Note 
that PLANPak II usually takes drive E: as the default drive for 
the user's data volume. Drive E: is also recommended for the 
user's volume name. Drives F: and G: are normally used by the 
application program volumes themselves. 


If you wish to create your own POST.MM file, go to the DOS 
environment, and execute the following commands: 


C> NET MOUNT :MAIN APPLICATIONS/LAN_MAIL,F:,RW 
C> DEL F: POST.MM 
C:- MENU LAN_MAIL 


The first statement mounts ‘MAIN/APPLICATIONS,/LAN_MAIL 
on drive F:. The second command deletes the file POST.MM 
from sMAIN/APPLICATIONS.LAN_MAIL. The third command 
chains back to the LAN:MAIL MONITOR menu. Select the “Run 
LAN:MAIL MONITOR manager” option. Follow the instructions 
in the LAN:MAIL MONITOR manual to create your own 
POST.MM file. 
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6.7.2 Sending and Receiving Mail Messages 


To send and receive messages on LAN:MAIL MONITOR, select 
the "send or receive mail message" option from the LAN:MAIL 
MONITOR menu. You will be presented with the LAN:MAIL 
MONITOR banner. See the LAN:MAIL MONITOR manual for 
specific instructions on sending and receiving mail. 


6.7.3 Testing and Using the Remote Communications 
Feature 


PLANPak II comes with LAN:MAIL MONITOR completely 
installed, including the Remote Communications feature. The 
Single User Remote feature is not available with PLANPak II. 


Note that the Remote Communications feature, as installed, is 
configured to run with a Hayes Smartmodem 1200 (1200 Baud). 
lf you wish to use a Hayes Smartmodem (300 Baud), or some 
other modem, access the AUTOEXEC.BAT file on the 
iMAIN/APPLICATIONS/MAIL_REMOTE volume as well as the 
iMAIN/APPLICATIONS/MAIL_TESTMODM volume, and change 
the “mode” setting from "1200" to the appropriate baud rate of 
your modem. Both ends should be used in the same modem 
at the same baud rate. 


Before using the Remote Communications feature, you need to 
verify that communication with the remote site has been esta- 
blished. To verify, select the "test modem for connection" option 
from the LAN:MAIL MONITOR menu. Follow the instructions in 
Chapter 2 ("Installation Procedures") of the LAN:MAIL MONI- 
TOR manual, starting with step four (“Installing the Hardware for 
Remote Communications"). 
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‘File Server Commands 


BLOAD pathname [,_LOAD= number} 
— loads binary virtual disk 


— loads at LOAD address in BLOAD, if present; if not, loads 
at LOAD address in corresponding BSAVE, if present; 
otherwise, loads at FROM address in BSAVE 


BRUN pathname [,LOAD = number] [,EXEC- number] 


— BLOADS a binary virtual disk, then executes it starting at 
the EXEC= address, if present; otherwise at EXEC 
address specified on file creation; otherwise at first 
address loaded 


BSAVE pathname,FROM=number,size [,LENGTH = number] 
[,LOAD = number] [,EXEC = number] 


— saves core image on disk of specified size, starting at 
FROM address, of SIZE or LENGTH (in bytes), for later 
loading (BLOAD) at LOAD and execution (BRUN) at 
EXEC 


CREATE pathname,type [,size] [,sectors] 
[,protection] [,drive] [,usage] 
[, LOAD = number] [, LENGTH =number] 
[,EXEC = number] 


— creates and optionally mounts a new virtual disk 


— LOAD, LENGTH and EXEC parameters apply to T=B 
volumes only. 
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DELETE pathname 
— deletes a virtual disk from system 
HELP [command name] or ? [command name] 


— displays list of commands or syntax of specified com 
mand 


INIT pathname, drive, [size] [,SYS] 
[, ENTRIES =entries][, VOLNAME = name] 
[,protection][, usage] 


— creates, mounts (for given usage, with given protection) 
and initializes a virtual disk of any size (certain environ- 
ments only), with the specified number of entries in the 
root directory VOLNAME is the DOS name to be 
assigned to the volume, if any 


LIST [pathname] [, VERBOSE] [,NESTED} 


— lists entries in default or specified directory 


LOCK lockname [:password] [,usage] [,USERS=number] 
[VAL = number] 


— locks “lockname” for exclusive (EXC) or shared (SHR) 
use, protected by the password if given 


— Default: EXC 


— The lock can be restricted to a maximum number of users 
by the USERS parameter (default is no limit) 


— an integer value can be given with VAL parameter (default 
is 0) 
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LOCK + lockname 

— increments lock value and returns old value 
LOCK- lockname 

— decrements lock value and returns old value 
MOUNT pathname, drive [,usage] 


— establishes correspondence between a virtual disk and a 
drive 


MOVE old pathname, new pathname 


— moves a volume or subtree (directory plus all its 
branches) from its current directory to a new directory 


OFF 


— unmounts all volumes, unlocks all locks, and clears any 
passwords or DIRS set (at the file server receiving the 
command). l 


NOTE: The ? command will return incorrect results after 
the OFF command is issued. 


PROTECT [pathname] [protection] 


— modifies passwords or access rights for a virtual disk or 
directory 


READLOCK lockname 


— returns current lock value 


COMMAND LIST 


REMOUNT <drive>[,usage] 
or REMOUNT ALL [,usage] 


— changes the usage of the mount on <drive> as specified. 
REMOUNT ALL remounts all drives on which there ts 
currently a mount (at the file server receiving the com- 
mand) 


RENAME oldpathname, newname 
— renames specified file server file 
SET DIR pathname 
— sets default directory 
SET [GRPPW= password] [PRVPW = password] 
— sets default group or private password 
SHOW DATE 
— displays date as MM/DD/YY 
SHOW INFO 
— displays information on a virtual volume 
SHOW DIR 
- displays name of current default directory 
SHOW LOCK [lockname] 


— lists all stations using specified lockname 
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SHOW [ALL] LOCKS 
— displays all locks set at own station or held in file server 
SHOW [ALL] MOUNTS [pathname] 


— gives information on virtual disks mounted on the file 
server 


SHOW PROTECTION [pathname] 


~ displays group, private and public access rights for virtual 
disk or directory addressed by pathname 


SHOW STATION 
— displays own station number 
SHOW TIME 
— returns current day of week, date and time 
SHOW TYPE drive 
— displays type of virtual disk mounted 
— loads at LOAD address in BLOAD, if present; if not, loads 


at LOAD address in corresponding BSAVE, if present: 
otherwise, loads at FROM address in BSAVE 


SHOW TYPES 


- displays types of virtual disks mounted on drives 1-16 
(corresponding to drives B: through O: in certain environ- 
ments) 


COMMAND LIST 


SHOW VOLS 


— displays names of system disk units currently operational 


TIMESTAMP 


— returns encoded form of the current date and time 


UNLOCK lockname or UNLOCK ALL 


— releases locked usage on a lockname or on all locknames 
currently held 


UNMOUNT drive or UNMOUNT ALL 


— cancels previous mount(s) 


WRITELOCK lockname,VAL =number 


— sets current lock value 


access rights: 


drive: 


filepath: 


lockname: 


name: 


Parameters 


set of letters from RWECDX (read, write, erase, 
create, delete and execute) 


d:, where d=letter A: to O: (in certain environ- 
ments) or Dn where n is a number (in other 
environments) 


name[:password] ['filepath] 
name of lock (same restrictions as name) 


name of disk unit, directory, or virtual disk.(1-15 
characters; no commas, control characters. 


number: 


password: 


pathname: 


protection: 


size: 


COMMAND LIST 


slashes, colons, returns or unprintable charac- 
ters; imbedded blanks ok; first character any ok 
character) 


if decimal: between -2 31 and 2°31-1 inclusive; 
if hex: between $0 and $FFFFFFFF, inclusive 


a secret word used to gain access to protected 
volumes. Same restrictions as name, except 
control characters allowed. 


/unitnamerfilepath or filepath 


(80 characters max.) An initial slash indicates 
first field is a unit name; no initial slash indicates 
current default directory is to be prefixed to 
pathname. 


protect item [,protection] 


protect item: 

GRPPW=password 

PRVPW =password 

PUBACC=access rights (Default: R) 
GRPACC=access rights (Default: PUBACC) 
PRVACC=access rights (Default: varies) 


SIZE =number [.size-unit] 


SIZE =0 causes an “extendible” volume to be 
created. Extendible volumes are virtual volumes 
of initial small size that can grow longer 
automatically, as needed. 
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size-unit: 
C. character--- (1 byte) 
S: sector----(256 bytes) 
B: block-----(512 bytes) 
blank: block (512 bytes) 
K: (1024 bytes) 


type: 
T=B (binary) T=S (system) 
T=C (Apple // CP/M) T=T (textfile) 
T=D (Apple // DOS) T=U (IBM PC p-System) 
T=I (IBM PC DOS) T=Y (directory) 
T=P (Apple :/ Pascal) T=3 (Apple +: SOS) 
T=R (server request) T=X (user defined) 


unitname: 1,2,3 or 4[:password]; or name[:password] 


usage: EXC(exclusive), SHR(shared) or UPD(UPDate) 
RO(Read/Only) or RW(Read/Write) 
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Network Upgrade 
DOS 1.1 to 2.00, 2.10 and 3.00 


B.1 New Capabilities 


(1) You can issue network commands from a program (in, for 
example, Pascal, compiled BASIC or assembler) through 
the character device "NCMD’. 


(2) VPRINT provides virtual printer support. 
(3) Up to 26 volumes (A-Z) are supported. 
(4) Compatible with DOS 1.1 virtual volumes. 


[Note: virtual volumes created using DOS 1.1 that are floppy 
disk size (640 blocks) are not accessible by DOS 2.0. They can 
be connected to DOS 2.0 format using a CONV640 utility avail- 
able from Nestar Technical Support. ] 


B.2 DOS 2.0 Changes 


(1) The NET commands SET VIRTUAL and SET REAL are no 
longer necessary. 


(2) The PC DOS 2.0 boot diskettes must contain the following 
files, in addition to those required by PC DOS itself: 


NETWORK.SYS 

CONFIG.SYS 

STARTUP.EXE or NET.EXE (optional) 
(STARTCMD if STARTUP.EXE is used) 
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(3) Network access for PC DOS 2.0 is implemented as a stan- 
dard DOS 2.0 driver. To access the network, DOS requires 
no modifications. 


(4) Volumes up to 65535 blocks (32MB) are supported. 


B.3 DOS 2.10 and DOS 3.00 


Since some software packages do not work under DOS 3.00, 
both DOS 2.10 (or DOS 2.00) and DOS 3.00 can be used simul- 
taneously at different workstations. Volumes INITed while in 
DOS 2.10 can be read and written while in DOS 3.00. Volumes 
INITed while in DOS 3.00 can be read and written while in DOS 
2.10. 


Note that programs distributed on the DOS 2.10 (or 2.00) library 
volume will not run under DOS 3.00. However, programs distri- 
buted on the DOS 3.00 library volume will run under DOS 2.10 
(or 2.00), or 3.00. 


Another difference occurs when INITing a boot volume with the 
SYS option (see Section 2.4). If the currently employed drive 
contains DOS 2.10 when the INIT command is given, the new 
volume will boot into DOS 2.10. If the currently employed drive 
contains DOS 3.00 when the INIT command is given, the new 
volume will boot into DOS 3.00. The volume can be read or writ- 
ten while booted (from another volume) into either version of 
DOS, but when booted, the version of DOS available is the one 
on that volume. 


WARNING: Do not use the SYS command to copy DOS 3.00 
onto a DOS 2.10 volume. If this procedure is used, the 
volume will NOT be bootable. Such is true for both hard 
disks and virtual volumes. A new volume should be INITed 
with the SYS option, then the files should be copied from 
the old volume to the new volume. 
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B.4 DOS 3.10 
Features of DOS 3.10 requiring the IBM PC Network Program, 


including file locks, and device and printer sharing, are not sup- 
ported on the network. 
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DOS Files Distributed on the Shared Library Volume 


A number of files necessary or useful in the DOS environment 
with the file server software are included on the shared library 
volume /MAIN/LIB/IBMPC.DOS. This list includes: 


ANSI.SYS FSCMDPAS.PAS NSR.ASM 
ART.BAS GRAFTABL.COM NSRC.H 
ASSIGN.COM GRAPHICS.COM NSRUNIT.ITF 
ATTRIB.EXE IBMIO.COM NU_AUTO TXT 
AUTOEXEC.BAT IBMDOS.COM NU_PRO1.TXT 
AUTOTEMP.BAT KEYBFR.COM NU_PRO2.TXT 
BACKUP.COM KEYBGR.COM NU_VPRN.HDR 
BALL.BAS KEYBIT.COM NWCMDS.COM 
BASIC.COM KEYBSP.COM PIECHART.BAS 
BASICA.COM KEYBUK.COM PRINT.COM 
CARDCHK.EXE LABEL.COM PRINTQ.EXE 
CHKDSK.COM LINK.EXE PROFILE.COM 
CIRCLE.BAS L4ASM.ITF RECOVER.COM 
CMDUNIT.ITF L4LOC.ASM RESTORE.COM 
COLORBAR.BAS MAKEBOOT.BAT SAMPLES.BAS 
COMM.BAS MAKESAMP.BAT SELECT.COM 
COMMAND.COM MENU.BAT SETPRINT.EXE 
COMP.COM MODE.COM SHARE.EXE 
CONFIG.SYS MORE.COM SORT.EXE 
CONTEMP.SYS MORTGAGE.BAS SPACE.BAS 
COUNT.EXE MUSIC.BAS STARTCMD 
DEBUG.COM MUSICA.BAS STARTUP.EXE 
DISKCOPY.COM NEST.COM SYS.COM 
DISKCOMP.COM NET.EXE TCOPY.EXE 
DONKEY.BAS NETBAS.LIB TEMPAUTO 
EDLIN.COM NETBAS.LST TNSRBAS.BAS 
EXE2BIN.EXE NETC.LIB TNSRBAS.EXE 
FDISK.COM NETC.LST TNSRC.C 
FIND.EXE NETCOB.LIB TNSRC.EXE 
FORMAT.COM NETCOB.LST TNSRCOB.COB 
FSCMDBAS.BAS NETCONFG.EXE TNSRCOB.EXE 
FSCMDBAS.EXE NETPAS.LIB TNSRPAS.EXE 


DISTRIBUTED DOS FILES 


FSCMDC.C NETPAS.LST TNSRPAS.PAS 
FSCMDC.EXE NETTEMP.SYS TREE.COM 
FSCMDCOB.COB NETUNIT.ITF VDISK.COM 
FSCMDCOB.EXE NETWORK.SYS — VDISK.LST 
FSCMDPAS.EXE NEWUSER.EXE 


Other useful files (e.g., support for compilers and assemblers) 
on /MAIN/LIB/IBMPC/DOS can be found in the following sub- 
directories: 


MASM 
PASCAL 
BASIC 
COBOL 
MSOFT 


Users may want additional files on the library volume (such as 
FORMAT and the other programs found on the IBM distributed 
diskette). l 


This can be done by using the NET program to mount the library 


volume with RW access and than using the DOS COPY com- 
mand to copy any desired files to the library volume. 
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Level 4 Error Codes 


Levels 4 and below of the network routines will occasionally 
display error codes on your screen. The format of the codes is 


NET <SSSS:0000 XX> or NET <XX> 


where SSSS:O0000 is the optional segment and offset of a 
request block, and XX is a two letter tag for the type of error. 


Should you receive any of these messages, contact your 
Nestar Technical Support Representative. 


Table D-1 translates the codes. 


Under “Options” in Table D-1 are codes which explain the vari- 
ous types of error or warning messages. "Rb" means that the 
address of the request block that caused the error is displayed. 
"Abort" indicates that the error is too severe for Level Four to 
continue and the abort vector in the publics has been branched 
to. "Opt" indicates an optional message controlled by bit four of 
L4_debug. (The "Opt" messages will not appear under normal 
operation.) 


ERROR CODES 


Tag 


Options 


ba 
bc 
bd 
bn 
br 
bs 
cs 
db 
dm 
do 
ds 
du 
iu 
la 
nr 
oc 
pd 
qo 
qu 
ra 
rb 
rf 
ro 
rp 
rq 
rr 
rs 
rt 
sa 
sb 
sr 
ss 
xf 


rb 

rb 

rb 

none 
rb 

rb 

rb abort 
opt 

opt 
rb,opt 
opt 
none 
abort 
abort 
none 
rb 
rb,opt 
abort 
abort 
rb,abort 
rb 
rb,abort 
abort 
none 
opt 

rb 
rb.abort 
rb.opt 
rb.opt 
rb,opt 
rb,opt 
rb,abort 
opt 


Table D-1 


Level Four Error Codes 


Description 


wrong State in acknowledge _now’ 
wrong state in connect” 

wrong state in disconnect’ 

bad NIC 

wrong state in receive msg* 
wrong state in send msg” 

bad connect state’ 

discard broadcast, no match 
discard, no match 

discard, out of sequence 

discard, too small 

station address same as another station 
L4 was called when in use 

loop ‘in active list 

bad NIC user ram 

wrong connect state in open receive’ 
received packet discard 

queue overflow” 

queue underflow” 

bad rb on active list" 

passed nil or bad signal rb 

bad rb on free_list* 

offset too large in remove _recv 
reduced performance mode (short packets) - 
receive queue timeout 

releasing rb not on active list 

bad receive state” 

receive wait timeout 

send abort 

send blocked timeout 

send retry 

bad send state” 

transmit fail in L2 


* NIC is bad or application is using Level 4 incorrectly. 


+ Indicates early version of NIC. Contact Nestar Technical Support. 
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INDEX 


A 


abort key 2-7 
“Abort, Retry, Ignore?" 1-7, 1-26, 2-32 
accessing real devices 1-27, 1-28 
accessing application programs, Fig. 6-1 6-3 
«Alt > 222 2-32, 3-2, 3-8, 3-18, 3-20, 3-21, 3-35, 3-36, 6-6 
<Alt) 999 2-8 
ANOTHER 5-28 
Apple // 
CPM 3-2 
DOS 3-2 
Pascal 3-2 
Apple /// 
SOS 3-2 
application programs 
accessing, Fig. 6-1 6-3 
adding to the menu 6-8 
DATASTORE:LAN vi, 1-1, 6-1, 6-6 
licensing agreement vi 
moving files to SuperCalc3 6-6 
LAN:MAIL MONITOR vi, 1-1, 6-1, 6-14 
accessing menu 6-14 
licensing agteement vi 
sending and receiving messages 6-15 
set up and maintenence 6-14 
testing and using remote communications 6-15 
selecting 6-1 
Shadow with 2-32 
SuperCalc3 3-3, 6-1, 6-2, 6-3, 6-6, 6-10, 6-11, 6-13 
files moved from DATASTORE:LAN 6-6 
licensing agreement iv 
SuperWriter 6-1, 6-4 
licensing agreement iv 


IN-1 


INDEX 


applications on the network 1-8, 1-9, 6-1 
accessing 6-1 thru 6-3 
from DOS environment 6-1, 6-2 
from startup 6-1 
adding an application 6-1, 6-8 thru 6-10 
how the networked applications run 6-10 thru 6-13 
from DOS environment 6-11 
from startup 6-10 
mounting data volumes at startup 6-7 
multi-users 4-35 
saving and printing data from 6-4 
selecting an application 6-1 
trying out applications 6-4 
APPLMENU profile 6-10, 6-13 
APPLUSER profile 6-8, 6-9 
booting from DOS environment 6-9 
booting from startup 6-9 
ASK 5-5 
assembler programs 4-30 
ASSIGN 1-29, 2-2, 2-12 
AUTOEXEC.BAT 1-8, 2-31 
on your boot volume 1-5, 1-8, 1 
onan application volume 1-8, 1- 
6-11, 6-12, 6-13 
on library volume 1-8, 6-11, 6-13 
on ;MAIN/APPLICATIONS/MAIL_REMOTE 6-15 
on /MAIN/APPLICATIONS/MAIL_TESTMODM 6-15 
automatic 
error recovery 2-25 
Startup 1-2, 4-2 
for Shadow 2-30 


9 ; 
-9, 6-8, 6-10, 
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INDEX 


BASIC 
compiled 3-24, 4-24 
disk and advanced 3-19 
file server commands from 4-11 
programs 3-19. 4-24 
spooled print requests 3-19 
BASIC profile command 1-17 
batch files 2-4 
bibliography BB-1 
binary 
file 4-34 
volume 4-1, 4-31, 4-34 
BIOS function calls 4-32 
BIOS upgrade kit 1-3 
boot 
diskettes (volumes) 1-1 
volumes, contents of 1-28 thru 1-30 
BOOT 
command 1-15 
menu 1-6 thru 1-8, 1-10 
program 1-4, 1-5, 2-31, 6-10, 6-11, 6-13 
profile program 1-13 
boot profile 
how to edit 1-13 
booting 1-1 
from a local floppy disk 1-27 
from a hard disk 1-27 
summary 1-10 
BRUN 4-1, 4-32 thru 4-36 
buffers 4-37 
BUFFERS 1-29 


IN-3 


INDEX 


C 


C programs 4-28 
file server commands from 4-13 
card 
printer interface 3-34 
CARDCHK 5-1, 5-34 
with Shadow 2-33 
changing primary and secondary file servers 2-18 
changing specific drives in Shadow 2-20 
channel command usage 2-22 
CLEAR 1-18, 5-4 
CLOCK$ Driver 1-42 
closing the virtual printer 3-2, 3-8, 3-18, 3-20, 3-21, 
3-36, 6-6 
CMD 4-14 
cmd; comment 5-3 
CMDLOOP 4-2 
CMDUNIT 4-3, A-2 
COBOL programs 4-26 
file server commands from 4-9 
code ` 
printer driver 3-35 
color control 1-23, 1-24 
COLOR c 5-27 
COMMAND 4-3, 4-5, 4-6 
command 
channel 2-15, 2-16 
usage 2-22 
list A-1 
COMMAND.COM 1-29, 1-30 
command;command 2-7 
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INDEX 


commands 
entering 
by DOS I’0 redirection feature 2-3 
by NET 2-3 
by NWCMDS 2-3 
file server 2-3 
issuing to secondary file server 2-19 
local 2-13 
network 2-3, A-1 
NOECHO 2-7 
profile 1-14 thru 1-22 
Shadow 2-17 
SYS 2-13 
comparison 
NPRINT versus virtual spooled network printer 3-2 
compiled BASIC 3-24 
programs 4-24 
compilers 4-1 
Microsoft/Lattice 4-2 
IBM Pascal 4-2 
concatenation facility of NET program 2-4 
CONFIG.SYS 1-2, 1-29, B-1 ` 
configuring 
boot diskettes 1-2 
drivers 1-43, 1-44 
contents of boot volumes 1-28 thru 1-30 
CONTINUE 5-5 
conventions, DOS naming 2-1 
COPIES 3-13, 3-26 
COPY 2-14, 3-1, 3-2, 3-4, 3-7, 3-8, 3-18, 3-36, 3-38 
copying files between environments 5-7 
COUNT utility program 5-1, 5-12 
matrix screen 5-15 thru 5-18 
skyline/token timing screen 5-12 thru 5-15 
with Shadow 2-33 
crashes, recovering from 2-20 
CREATE 2-8, 2-16 


IN-5 


INDEX 


creating 
identical Shadow volumes 2-24 
network bootable diskettes 1-31 1-32 
virtual volumes 2-8 thru 2-12 
your own profiles 1-12, 1-13 
«<Ctrl> <. Alt><:Del> 1-2 
<Ctrl.--:PrtSc> 2-6, 3-8, 3-34 


D 


data entry 4-43 
data volumes vi, 1-9, 6-4, 6-8, 6-14 
how to mount automatically at startup 6-7 
when a personal profile does not exist for your 
station 6-8 
when a personal profile exists for your station 6-8 
how to mount manually from DOS environment 6-5 
how to mount manually from startup 6-5 
DATASTORE:LAN 1-1, 6-1, 6-5 
licensing agreement vi 
moving files to SuperCalc 6-5 
DATE 3-12 ° 
"D300 Rom" 1-2 
DEBUG.COM 3-16 
DEBUB.EOF 3-16 
default 
drive 1-9, 6-4, 6-8, 6-14 
escape sequences 3-15 
file server 2-7, 2-15, 4-4 
changing 2-15 
print options, NPRINT 3-23 thru 3-29 
how to preset 3-29, 3-30 
profile 1-5 
DEFAULTS file 3-29 thru 3-32 
design issues 4-36 
directories 2-1 
DIRS A-3 
disclaimer ii 


IN-6 


INDEX 


disk 
and advanced BASIC 3-19 
LO error 2-28 
organization 2-1 
RAM 2-2 
DISKCOMP 2-14 
DISKCOPY 2-14 
disks, virtual, see also diskettes 
creating 2-3 
deleting 2-3 
mounting 2-3 
renaming 2-3 
diskettes 
size 2-1, 2-7 
virtual 2-1 
distributed DOS files on /MAIN/LIB/IBMPC,DOS C-1 
DONE 4-15 
DONEFLAG 4-5, 4-6 
DOS 
ASSIGN 1-29, 2-2, 2-12 
condition 
ERRORLEVEL 5-19, 5-20 
COPY 2-14, 3-1, 3-2, 3-4, 3-7, 3-8, 3-18, 3-36, 3-38 
DISKCOMP. 2-13 
DISKCOPY 2-13 
environment 6-11 
files distributed on /MAIN/LIB/IBMPC/DOS C-1 
FORMAT 2-6, 2-12 
function calls 4-32 
VO redirection feature 2-3 
naming conventions 2-1 
updates to later DOS versions B-1 
conditions resulting from 2-13, B-2 
virtual volumes 2-1 
drive usage 2-22 
drivers 1-38, 1-39, 1-41, 1-42 
virtual disk 1-41 
virtual printer 1-42 
drives 2-1, 2-9, 2-15, 2-16 
changing specific drives in Shadow 2-20 
real 2-2 
virtual 2-1, 2-2 


IN-7 


INDEX 


E 


ECHO 1-18, 
echo all characters appearing on screen 3-8 
ECHO OFF 6-10 
editing boot profiles 1-13 
EJECT 3-13, 3-27 
eject value 3-31 
ENDMENU 1-19 
ENTER 5-5 
entering commands 
by DOS 1/0 redirection feature 2-3 
by NET 2-3 
by NWCMDS 2-3 
entering parameters on the command line 5-9 
ENTRIES 2-9 
EOF (End of File) file 3-16 
error messages 2-3, 5-40 
installation 5-28 
level 4 D-1 
network 2-17, 2-18 
while booting 1-2, 1-26, 1-30 
while processing from compiled BASIC 4-12 
while using NET program 2-6 
error processing from compiled BASIC 4-13 
ERRORLEVEL 5-19, 5-20 
ERRORS 1-22 
errors in Shadow, recovery from 2-25 
ESC 3-15 thru 3-18 
Escape 1-24, 3-14 
escape sequences, virtual printer 3-15 thru 3-20 
default 3-15 
ESC V 3-15 thru 3-18, 3-20 


IN-8 


INDEX 


F 


Feature Care, Print Server 3-4 
FILE NAME(S) 3-23 
FILE SERVER 3-24 
file server 
changing primary and secondary 2-18 
commands 2-3 thru 2-6, 4-2, 5-19, 5-20, 5-32, A-1 
from C 4-14 
from COBOL 4-9 
from compiled BASIC 4-12 
from other languages 4-17 
from Pascal 4-2 
sending 2-16 
crashes. recovering from 2-20 
default 2-7 
hangs 2-27 
incapacitated 2-27 
primary 2-20 
secondary 2-16, 2-20 
issuing commands to 2-19 
turning off 2-18 
turning on 2-18 
Shadow use 2-15 
turning off 2-20 
file servers, multiple 1-25, 3-5, 3-34 
File Transfer Server 2-24, 2-33 
files 
network 2-1 
NEWUSER template 1-33 
filing system 4-36 
FORMAT 2-8 
FS command channe! 2-13 
FS PATHNAME 3-24 
FS $NN 2-18 
FSCMD 4-1, 4-4, 4-10, 4-14 
FSCMD1 4-5 
FSCMDPAS 4-7 
FSRSP 4-1, 4-10 
FTS 2-24, 2-33 


IN-9 


INDEX 


function calls 

BIOS 4-32 

DOS 4-32 
function keys 1-6. 1-7 


H 


hard disks, network (shared) 2-1 
Hayes Smartmodem 6-15 
Hayes Smardmodem 1200 6-15 
header items, virtual printer 3-12 
headers, virtual printer 3-9 
highlighting control 1-23, 1-24 


identical volumes with Shadow 2-19 
IDENTIFICATION 3-26, 3-31 
I/O redirection feature 2-3 
"I" type volume 2-10, 2-12 
IBM BIOS upgrade kit 1-3 
IBM 
DOS 3-2 
p-System 3-2 
IBM Pascal Compiler 4-2 
IBM PCs, upgrading early 1-3 
IBM Technical Reference Manual 1-24 
IBMBIO.COM 1-29, 2-13 
IBMDOS.COM 1-29, 2-13 
ID 3-11 
"Ignore?" 1-7, 1-8, 2-32 
incapacitated file server 2-27 
INIT 2-1, 2-3, 2-6, 2-8 thru 2-12, 2-16, 2-25, 4-2, 5-20 
with previous versions of DOS 2-13 
initializing a virtual volume 2-6 
installation error messages 5-28 
interrupt test 5-39 
interruptions in Shadow operations 2-25 
interrupts 2-28 
“Invalid Read/Write code” 2-20 


IN-10 


INDEX 


K 


KEY n 5-25 

KEY Fn 5-26 

KEY On 5-26 

keyboard commands 1-26, 1-27 


L 


languages, network commands in 4-17 
LAN:MAIL MONITOR vi, 1-1, 6-1, 6-11 
accessing menu 6-14 
licensing agreement vi 
sending and receiving messages 6-15 
set up and maintenence 6-14 
testing and using remote communications 6-15 
Level 4 D-1 
error codes D-1 
MLBABMPC/DOS 1-8, 1-30 thru 1-32, 3-35, 5-1, 5-2 
library routines to access network facilities 4-1, 4-2 
library Volume 1-8, 2-3, 6-13 
linkable device drivers 1-38 
local commands 2-3, 2-13, 5-20, A-2 
local printer 3-1, 3-19, 3-35 thru 3-39 
and virtual spooled network printer 3-35, 3-36, 3-38 
before using 3-35 
used simultaneously with virtual spooled printer 3-36 
Locate function in COUNT 5-16 
LOCK 2-26, 2-28 
Locking 4-45 
logging on, first time 1-4 
LPT1 1-42, 3-2, 3-7, 3-8, 3-9, 3-18, 3-19, 3-20, 3-35, 3-36, 
3-37, 3-38, 3-39 
LPT3 3-7, 3-8, 3-9, 3-19 


IN-11 


INDEX 


Mail Messages 6-14 
iMAIN: APPLICATIONS. '_AN_MAIL 6-15 
‘MAIN: APPLICATIONS: MAIL_REMOTE 6-15 
‘MAIN APPLICATIONS. MAIL_TESTMODM 6-15 
MAIN. LIB-IBMPC.DOS 1-8, 1-30 thru 1-32, 3-35, 5-1, 5-2 

files distributed on C-1 
MAIN: SYSTEM.NAMES 5-24, 5-28 
iMAIN.SYSTEM,PROFILE 1-10, 1-12, 1-13 
manuals, list of BB-1 
map, resource 2-2 
mass storage 2-1 
matrix screen 5-16 

(Linear) Fig. 5-3 5-18 

(Log Scale) Fig. 5-4 5-20 
media problems 2-28 
MENU 1-19, 2-31 
MENU.BAT 6-11, 6-12, 6-13 
menu, boot 1-5, 1-8, 1-10 

leaving 1-7, 1-11 

‘using 1-11 
menus, PLANPak II™ 

accessing 6-1 thru 6-3 

from DOS environment 6-1, 6-2 
from startup 6-1 

Messenger 2-32 
meter toggle option in COUNT 5-16 
Microsoft Lattice Compiler 4-2 
“Missing or invalid Read/Write code" 2-20 
MOUNT 2-16, 6-4, 6-5, 6-8 
multi-user applications 4-35 
multiple file servers 1-25, 3-5, 3-34 
multiple print server setups 3-5 
multiple printers 3-5 


IN-12 


INDEX 


N 


NAME 2-31, 3-12 
naming conventions (DOS) 2-1 
NCMD 1-40, 1-41, 4-17 
NE TEST ERRORS 5-45 
NEST utility program 2-5, 2-8, 2-16, 2-18, 2-32. 5-1. 5-21 
NET 2-3, 2-32 
command 2-25 
commands 2-6 
entering commands by 2-3 
file server commands 5-3 
keyword 5-3 
program 2-1, 2-6, 5-3, 6-4, A-2 
concatenation facility 2-4 
output 2-6 
prompt 2-3 
NET.EXE 1-29, 1-39 
NET_CLOSE 4-1, 4-20 
NET/NEST 2-32 
NET_OPEN 4-1, 4-19, 4-20 
“NET_RECV 4-1, 4-21 
NET_SEND 4-1, 4-21 
net<bn>> 1-2 
net<du> 1-2 
net<nr> 1-2 
NETBAS.LIB 4-11 
NETCOB.LIB 4-9 
NETCONFG 1-43, 1-44, 3-8, 3-19, 3-35, 3-36, 3-38, 3-39, 5-2 
NETCONFG.EXE 3-35 
NETPAS.LIB 4-2 
NETUNIT 4-2, 4-4 


IN-13 


INDEX 


network 2-1 
access test 5-39 
commands 2-3, 2-6, 2-13 
in other languages 4-17 
device driver 4-1, 4-31 
driver 3-35 
reconfigure with NETCONFG 1-43, 1-44, 3-8, 3-9, 
3-35, 3-36, 3-38, 3-39 
drivers file 1-38, 1-39 
drives 2-1 
files 2-1 
hard disks, shared 2-1 
interface card 5-1, 5-15 
interrupt test 5-39 
print request program (NPRINT) 3-1, 3-2, 3-4, 3-22 thru 3-34 
how to print a file 3-21 
multiple print servers 3-33 
print options 3-23 thru 3-29 
how to preset defaults 3-29 thru 3-33 
print request form 3-22 
versus virtual spooled network printer 3-2 
printers 
print request program (NPRINT) 3-1, 3-2, 3-4, 
3-21 thru 3-34 
virtual spooled 3-1, 3-2, 3-7 thru 3-20, 3-36 
send and receive support code 4-18 
upgrade to later DOS versions B-1 
differences between previous versions and 3.10 2-13, B-2 
utilities 5-1 
virtual spooled printer 3-1, 3-2, 3-7 thru 3-20, 3-36 
“Network Timeout" 2-27 
Networked Application Programs, 6-1 through 6-14 
Accessing 6-3 
Adding to Menu 6-8 
DATASTORE:LAN to SuperCalc3 6-5 
How they run 6-10 
LAN:MAIL Monitor 6-11 
Mail Messages 6-14 
Moving Data Volumes Automatically at Startup 6-7 
Remote Communicati ons Feature 6-14 
Saving and Printing Data 6-4 


IN-14 


INDEX 


Selecting 6-1 
Setup and Maintenance 6-13 
Startup 6-10 
From the DOS environment 6-11 
Trying Out 6-2 
NETWORK.SYS 1-2, 1-38, 1-39, B-1 
NEWCMD 4-14 
NEWCMDFLAG 4-5, 4-6 
NEWS 5-4 
NEWUSER v, 1-33 thru 1-38, 5-1 
NIC 5-1, 5-15, 5-32, D-2 
NPRINT 3-1, 3-2, 3-4, 3-21 thru 3-34 
comparison of... and the virtual printer 3-2 
how to print a file 3-21 
multiple file servers 3-33 
print options 3-23 thru 3-29 
how to preset defaults 3-29 thru 3-33 
print request form 3-22 
versus virtual spooled network printer 3-2 
NOCOLOR 1-23, 1-24 
NOECHO 1-7, 1-18, 1-19, 2-7, 5-3 
NSR 4-17 
NSRUNIT.ITF 4-22 
NWCMDS utility iv, 2-3, 2-8, 2-16, 3-9, 4-15, 5-1, 5-23, 5-32 
already installed 5-28 
bad color specification 5-29 
bad number of pages 5-29 
bad trigger character 5-29 
bad window specification 5-29 
L4 locate error 5-29 
LPT3 driver not found 5-30 
NCMD driver not found 5-30 
unrecognized operand 5-29 
window, Fig 5-5. 5-31 


IN-15 


INDEX 


O 


OFF A-3 

optional installation parameters 5-25 

options, print (NPRINT) 3-23 thru 3-29 
how to preset defaults 3-29 thru 3-33 

OPTIONS 4-3 


p 


PAGE TITLE 3-26, 3-31 
PAGES n 5-27 
Partial Tape Dump Restore utility 2-24 
Pascal 4-2, 4-22 
PASCAL.LIB 4-2 
PASCAL programs 4-22 
PASSWORD 5-5 . 
passwords. profile 1-16, 1-17 
pathname 2-1, 2-9 
PAUSE 1-17 
PE 2- 
personal work volume 1-4 
PIT test errors 5-43 
PLANPak II™ 1-1, 6-1, 6-4, 6-8, 6-11, 6-15 
default drive 6-4, 6-8, 6-14 
memory requirements 1-1, 6-1 
menus 
accessing 6-1 thru 6-3 
from DOS environment 6-1, 6-2 
from startup 6-1 
POST.MM 6-14 
how to create your own 6-15 
primary file server 2-15 
changing 2-18 
primary volumes 2-19 
PRINT 1-18, 5-4 
<anystring’- 2-7 
print options, NPRINT 3-23 thru 3-29 
how to preset defaults 3-29 
print request, tracking 3-37 


IN-16 


INDEX 


print request form 3-22 
presetting defaults for 3-30 
print request program (NPRINT) 3-1, 3-2, 3-4, 3-21 thru 3-34 
how to print a file 3-21 
multiple file servers 3-33 
print options 3-23 thru 3-29 
how to preset defaults 3-29 thru 3-33 
print request form 3-22 
versus virtual spooled network printer 3-2 
PRINT SERVER 3-27, 3-31 
print server 3-1, 3-4 
programs 3-4 
setups 3-4 
station 3-4 
Print Server Feature Card 3-4 
PRINT string 5-4 
PRINTER 3-13 
PRINTER MODEL 3-27, 3-31 
printer driver code 3-35 
printer interface card 3-35 
printer "setups", user specified 3-4 


printers 
local 3-1, 3-19, 3-35 thru 3-39 
multiple 3-5 


virtual spooled network 1-42, 2-33, 3-1, 3-2, 3-7 thru 3-20, 3-36 
printing a file 3-23 ` 
printing options 3-24 
PRINTQ 3-40 thru 3-42, 5-2 

with Shadow 2-33 
PRIORITY 3-13, 3-28, 3-31 
PRN 1-42, 3-2, 3-7, 3-8, 3-9, 3-20, 3-35, 3-36, 3-38, 3-39 
PROFILE 1-10, 1-15 thru 1-18, 6-8 

(@GNN 1-25 

$nn 2-31 

name 2-31 

program 6-11, 6-13 


IN-17 


INDEX 


profile 
commands 1-13 thru 1-25 
creating your own 1-12, 1-13 
customized to mount data volumes at startup 6-7 
editing 1-13 
Profile volumes 1-4 
customized to mount data volumes at startup 6-7 
editing 1-13 
which to use 1-10 
programmable interval timer test 5-38 
programming 4-1 
PROMPT 4-3 
protection 2-10 
PS 2-20 


Q 


"Q" 2-3 
QUIT 2-3, 5-6 


R 


RAM disk 2-2 
RAM test 5-38 
RC 4-4, 4-5 
read/write code 2-20 
real 
devices, accessing 1-27, 1-28 
diskettes, 
creating 1-31 
startup 1-1 
drives 2-2 
receive support code 4-17 
recovery 
from errors in Shadow 2-25 
from file server crashes 2-20 
from incapacitated file server 2-27 
remote communications, LAN: MAIL MONITOR 6-15 


IN-18 


INDEX 


rename virtual printer device using NETCONFG 1-43, 1-44, 


3-8, 3-19, 3-35, 3-36, 3-38, 3-39 
REQTYPE:PRINT 3-11 
resource maps 2-2 
RESPONSE 4-5, 4-6 
Restore utility 2-24 
“Retry?” 1-7, 2-32 
RIM INTERRUPT NOT SEEN BY HOST 5-44 
RIM RAM buffer test 5-38 
RIM RAM TEST ERRORS 5-41 
RIM test 5-38 
RIM TEST ERRORS 5-41 
ROM test 5-38 
ROM TEST ERRORS 5-40 
root directory 2-9 
routines. library, to access network facilities 4-1 
RSP 4-15 


S 


SDI 
Format file 6-6, 6-7 
Program 6-6, 6-7 
SDI.COM 6-6 
SE 2- 
secondary file server 2-16 
changing 2-18 
issuing commands to 2-19 
secondary volumes 2-19 
selftest at startup 1-2 
sending 
file server commands 2-16 
virtual printer escape sequences 3-17 
SERVER 3-13 
SET DATE 5-3 
SET FS $NN 2-7, 2-18 
SET USER 5-3 
SETPRINT 3-2, 3-10, 3-11, 5-1 
with Shadow 2-33 
SETUP 3-13, 3-28, 3-31 


IN-19 


INDEX 


setup 3-4 
setups, multiple 3-5 
Shadow 
and CARDCHK 2-33 
and COUNT 2-33 
and PRINTQ 2-33 
and SETPRINT 2-33 
and TCOPY 2-33 
and 3278 Emulator 2-33 
automatic startup 2-30 
changing drives 2-20 
commands 2-17, 2-31 
creating identical volumes 2-24 
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HOW TO 


How to Find Information in This and Other 
PLAN Series Manuals 


This manual is designed to provide a description of those PLAN 
File Server functions that are specific to the IBM Personal Com- 
puter DOS 2.10 and DOS 3.10 environments. 


For an introduction to the network, read the General Information 
Manual. 


For general information pertaining to shared hard disks on the 
network and network commands issued to them by worksta- 
tions, read the PLAN Series Network Command Reference 
Manual. 


PLAN Series networks support Apple, IBM PC, and compatible 
workstations running under a variety of operating systems. 
Some network facilities are available only in the IBM PC DOS 
environment. Among them are 


Startup using menus Section 1.2 
Secondary (Shadow) file server Section 2.8 
Virtual and spooled printing Section 3.2 
COUNT (network activity) utility program Section 5.3 
NWCMDS (window access to network) Section 5.5 
CARDCHK (network interface card) test utility Section 5.6 
PLANPak business application package Section 6.1 


These facilities are described in this manual. 


Network installation and configuration are described in the Phy- 
sical Planning Manual, the PLAN 3000 (or 4000 or 5000) Quick 
Installation Guide, the Network Installation Reference Manual, 
and the Print Serve; Installation and Operation Manual. 


The PLAN Series General Index indexes the contents of seven 
core PLAN Series manuals. 


A bibliography of system manuals and guides appears at the 
end of this guide. 
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This Manual 


The material in this document applies to Version 2.3 of the 
PLAN File Server software. 


Chapter 1 of this manual explains how to enroll a first-time user 
on the network using the NEWUSER utility, and how to config- 
ure workstations for "customized" startup. For users of PLAN- 
Pak II™, the Nestar package of application programs, additional 
startup information is found in Chapter 6. 


Chapter 2 explains how to share network disks. A general dis- 
cussion of disk sharing network commands, true for all com- 
puter operating system environments, is found in the PLAN 
Series Network Command Reference Manual, which can be 
used for reference. The Shadow File Server is also discussed in 
detail in Chapter 2. 


Chapter 3 discusses the print server and the shared printing 
option with VPRINT (or the Virtual Printer), available on the net- 
work. Section 3.4 outlines how to use a local printer. 


Chapter 4 offers information on accessing the network from 
Pascal, Cobol, Compiled BASIC, and C programs, and from 
other languages. Multi-user applications are also discussed. 


Chapter 5 discusses utility programs provided on the network: 
the STARTUP utility executes a file of commands on the 
workstation’s default volume at initialization time (supplements 
AUTOEXEC.BAT). The TCOPY utility allows workstations to 
copy text files from one microcomputer/operating system 
environment to another. The COUNT utility is a network monitor 
program that tabulates network activity. The NEST utility allows 
workstations to direct file server response codes to the DOS 
condition ERRORLEVEL instead of to the workstation console 
screen. The SETPRINT utility allows workstations to specify 
print server header items and write them directly to a virtual 
printer, or to a file for later use. The NWCMDS utility allows 
access to any file server or, by its subset VPCMDS, access to 
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the virtual printer, from within any program environment via a 
scrolling window. CARDCHK is used to test Network Interface 
Cards (NICs) and diagnose problems. 


Chapter 6 contains information on PLANPak II, a starter library 
of application programs (SuperCalcs3, SuperWriter, 
DATASTORE:LAN, and LAN:MAIL MONITOR) distributed with 
the PLAN Series software. Due to a licensing agreement, 
SuperCalc3 and SuperWriter can be used concurrently by 
no more than 4 persons without additional license fees. 
DATASTORE:LAN and LAN:MAIL MONITOR can be used 
concurrently by an unlimited number of persons. However, 
no more than 5 people can concurrently share the same 
DATASTORE:LAN database (file). An upgrade is available 
for DATASTORE:LAN which permits up to 12 concurrent 
users of a single database. 


Also provided are instructions on accessing and using the appli- 
cation programs, saving and printing data from application pro- 
grams, mounting data volumes automatically at startup, and 
adding additional application programs to an applications menu. 


Additional information is provided in four appendices. 
Appendix A contains a list of file server commands. 
Appendix B discusses the usage of DOS 2.10 and 3.10. 
Software upgrades are discussed in Appendix B of the PLAN 


Series Network Command Reference Manual. 


Appendix C contains a list of DOS files distributed on the 
shared library volume /MAIN/LIB/IBMPC/DOS. 


Appendix D provides a list of Level 4 error codes, the transla- 
tion of each code, and what to do upon receiving an error code. 


We welcome criticisms and suggestions. Forms for reporting 


program errors and documentation errors or inadequacies are 
provided at the back of this manual. 
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If you want to... 


Customize your workstation 
startup 


Get more work space on the 
network hard disk 


Read about “network” commands 
that allow you to create, access, 
and delete space on shared 
network disks 


Use a backup "shadow" file 
server 


Print a document 
Change printer margins 


Have your name printed on the 
cover page 


Use both local and network 
printers 


Use the COPY command to print 
on a network printer 


Prevent someone from reading 


or modifying your data 


Read about network hardware 
installation Manual 


Read about file server 
facilities 


System manager tasks 
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1.11.2 Virtual Disks 


The library volume //LIB/IBMPC/DOS is a bootable volume as 
shipped with your system. Being much larger than a floppy disk, 
this volume is slower to boot than a smaller disk because its 
FAT and directory are larger, both of which must be brought into 
the memory of your IBM PC during boot. Also the volume must 
be mounted on drive C:, which may or may not be the most 
convenient way to boot. Therefore, you may want to make a 
bootable virtual volume smaller than the library volume. 


To create a virtual bootable volume, first boot the library volume 
/LIB/IBMPC/DOS. Then run the NET program. Use the com- 
mand INIT to create and initialize your virtual volume. 


To boot on drive A: the SIZE that you specify in the INIT com- 
mand should be left blank, thus creating a 720 sector volume, or 
the SIZE should be specified as 320, 360, 640 or 720 sectors. 
Any of these volume sizes is appropriate for a "small" floppy- 
sized volume. 


To boot only from drive C:, specify any size or leave blank. 


In addition, specify the SYS option on the INIT command. The 
SYS option will make the virtual volume bootable. At the suc- 
cessful conclusion of the INIT command, the new volume will be 
bootable. 


Additional files that can be put onto the volume to govern the 
booting process are documented in Chapter 4 of the /BM DOS 
Version 3.10 Reference. 


In order to use virtual volumes other than the one you boot 
from, you need to use the CONFIG.SYS and NETWORK.SYS 
files. In order to automatically execute a program when the 
booting process is completed, you need the AUTOEXEC.BAT 
file. These files can be copied from the library volume after the 
INIT command is completed. 
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1.11.2.1 Logging On For the First Time using the Nestar 
"Newuser” Main Option 


At power-on or after rebooting your machine the Nestar Main 
Menu will appear unless you have modified your network pro- 
files. The Main Menu, as shipped, prompts you to provide a 
password ("Nestar"). To log on to the network for the first time 
(or to enroll any new user) and to create a personal work space 
on the network disk that will be available to the user at startup, 
select the “PLANPak Applications” option from the Nestar Main 
Menu. From the “PLANPak Applications Menu" select the “Net- 
work utility programs" option and then the “NEWUSER" option. 


NEWUSER may also be accessed by entering NEWUSER from 
the distributed volume //LIB/BMPC/DOS. 


The NEWUSER program creates a workstation profile that 
chains to a user profile, a user profile that boots the library 
volume on drive C: and an IBM PC DOS personal volume on 
drive E: (containing an AUTOEXEC.BAT file), and virtual printer 
parameters. (For details on AUTOEXEC.BAT files, see Section 
1.2.4; for virtual printer parameters, see Chapter 3; for the form 
and contents of the NEWUSER templates, see Appendix G of 
the PLAN Series File Server Installation and Operation Manual.) 


Do not mount any volumes while running NEWUSER, or the 
program may terminate abnormally. NEWUSER searches 
from drive Z: to drive A: for an available virtual drive to 
create T=T and T=I volumes. This drive is unmounted 
before the utility completes its program. 


NEWUSER will prompt you as follows: 


(1) Enter the Drive Where Template Files Are Kept: 


Enter a letter, A - Z, to designate the drive where the 
NEWUSER "templates" are mounted. The drive letter can 
be entered in upper or lower case. Do not use a colon 
after the letter or enter any blank spaces after prompts. 
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Profile $nn (where $nn refers to //SYSTEM/PROFILE/$nn, with 
$nn the station address) contains the lines: 


MOUNT /MAIN/LIB/IBMPC/DOS,C: 
MOUNT /MAIN/USERS/DATA,E:,RW 
BOOT E: 


NOTE: Shadow commands are not supported by the BOOT 
program, only by the MENU command. 


AUTOEXEC.BAT on E: contains the line: 
MENU <name> 


(where <name> is //SYSTEM/PROFILE/NAME). 


Profile name contains the lines: 


MENU 

> Turn on shadowing 
@$FE&$FD 
MOUNT /MAIN/USERS/DATA,E:,RW 
BOOT E: 


> Run applications without shadowing 
MOUNT /MAIN/USERS/DATA,E:,RW 
BOOT E: 


in this scheme DOS is booted from the library volume on drive 
C: at startup. Commands in the AUTOEXEC.BAT file on drives 
C: and E: are executed. AUTOEXEC.BAT invokes the distri- 
buted MENU.BAT file (Chapter 6), which executes the com- 
mands in the profile NAME. 


"NAME" contains two menu items. Both remount the user 
volume and log on to it, one with both $FE and $FD turned on, 
the other with only the file server that originally booted the 
workstation. 
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If either file server is down, an “Abort, Retry, Ignore?" message 


will be returned when the @$FE &$FD line is reached. Press "I" 


for “Ignore” to continue with one file server. 
The profiles “$nn" and NAME (or whatever you choose to call 


them) should be put on both $FE and $FD. If either file server is 
down, work can continue on the other. 


2.6.6 Considerations for Shadow Use with Network 
Application Programs 

2.6.6.1 Virtual Printer 

Virtual Print requests will be spooled on the primary file server. 

lf the primary file server goes down before the spooled file is 

closed (by <Alt> 222 for example), the’ spooled material may 


be lost. The secondary file server does not play a part in virtual 
printing. 


2.6.6.2 The Messenger ™ 


Shadowing should not be used in conjunction with the 
Messenger unless 


(1) sender and receiver both use the Shadow, and 


(2) all messages are to be shadowed. 


2.6.6.3 NET/NEST 
There are Shadow considerations beyond those discussed in 


previous sections. (NET can be used to create identical Sha- 
dow volumes, Section 2.6.3.) 
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2.6.6.4 TCOPY 

If the default server is set to both a server and its Shadow, 
TCOPY will generate a shadowed file and read it back from 
either. 


2.6.6.5 File Transfer Server 


FTS can be used to create identical Shadow volumes (Section 
2.6.3). 


2.6.6.6 COUNT, 3278 Emulator, SETPRINT, CARDCHK 


There are no Shadow implications when using these utilities. 
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Chapter 3 


Printing 


3.0 Introduction 


This chapter provides information on print servers (see Section 
3.1) and on the shared network printing option, which is avail- 
able to users. This option is called VPRINT (see Section 3.2). 


If your network does not have a print server instalied, Sec- 
tions 3.1 and 3.2 do not apply to you. See Section 3.4 on 
Local Printers. 


The virtual printer is software that allows the user to employ 
the DOS COPY command to send files and keyboard input to a 
network printer (just as he would send input from a standalone 
computer to a local printer). The input is then spooled (written 
to a temporary file) to be printed in its turn by a network printer. 
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Using VPRINT 


VPRINT prints only IBM PC DOS files. 
Volumes that contain files to be printed must be mounted. 


In order to print a file, use the DOS COPY command and 
specify the printer: 


COPY filename LPT1 (or PRN or LPT3) 


(See Section 3.2.1.) 


In order to print, you do not have to do anything else. If no 
data is sent to the virtual printer for 15 seconds, the virtual 
printer will automatically close itself. (See Section 3.2.8 and 
3.2.9.) 


The default values for printer, header ID page, user name, 
as well as other options can be set by using SETPRINT 
(Section 3.2.5), VPCMDS or NWCMDS windows, (Section 
3.2.4), or print parameters can be set by entering escape 
sequences (Section 3.2.7). 


VPRINT looks like a real printer to DOS. Application pro- 
grams such as SuperCalc3 can print to it. (See Section 
3.2.7.) 


Files from local devices can be printed with the virtual 
printer. (See Section 3.4) 
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3.1 Print Servers 
The Print Server Programs 


The Print Server package consists of user and server programs. 
The user software, which is invoked by users at their worksta- 
tions, allows data to be spooled (put into files that wait to be 
printed) using the DOS COPY command. Spooled data and 
print requests are sent to the file server's hard disk where they 
wait as virtual volumes. The server software processes these 
volumes and manages the printing of requests. 


The Print Server Station 


A print server station is a standalone computer or a Print Server 
Feature Card located inside a file server that runs special print 
server software. The programs running on these stations check 
the request queues on the hard disk periodically, taking 
requests in the order they were issued but considering special 
user specified priorities. The print server software verifies that a 
printer is available and set up to do the job. If it is, the job is 
completed. See Figure 3-1. 


User Specified Printer "Setups" 


A printer is capable of printing according to varying length-of- 
page specifications on different types of. paper and, in some 
cases, in different fonts. Users specify in their spooled data or 
print requests which printer “setup” they want. The print server 
will check to see if that particular setup specification is sup- 
ported on the specified printer. If it is not, the print server will 
delay the request until instructed by you that the setup is 
currently available. Meanwhile, users who have other currently 
supported preferences can issue requests that can be printed 
almost directly. 


There are many characteristics that determine a setup. You can 
Create specifications at your installation for all the needed 
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3.2 Virtual Printer 


The virtual printer is a character device that will accept text and 
write it to a file server volume on the primary file server for that 
station. A print server can then print the text from this volume. 
Any number of stations can generate such volumes simultane- 
ously, and one or more print servers can service the queues of 
volumes waiting to be printed. 


The virtual printer is used to redirect the output of various user 
utility and application programs, such as compilers and some 
word processors, to a network printer instead of a to local 
printer. Virtual printers are also useful for listing files on local 
disks to a network printer. 


3.2.1 Using the Virtual Printer 

The network driver, as distributed, includes a virtual printer dev- 
ice named LPT1 (alias PRN). The virtual printer (see Figure 3-2) 
can also always be accessed under the name LPT3. To get a 


printout, use the command 


COPY filename LPT1 (or PRN or LPT3) 


Figure 3-2 
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After issuing the COPY command, the virtual printer will close 
automatically after 15 seconds. 


To echo all characters appearing on the screen to the virtual 
printer, press <Shift><PrtSc>. To echo all characters continu- 
ously from the screen to the virtual printer, press 
<Ctrl><PrtSc> to start and <Ctri><PrtSc> again to stop. in 
both cases the virtual printer will close after 15 seconds of no 
printing. The <Shift><PrSc> and <Ctri><PrtSc> keys 
always write to the printer device named LPT1, whether local or 
virtual. 


The NETCONFG program can be used to rename the virtual 
printer device VPRN (alias VPRN2) when a local printing device 
is also present (see Section 3.4.2). The NETCNFG program can 
also be used to change the time until the printer closes or to dis- 
able the <Alt> 222 and timeout completely. 


Names that correspond to the virtual printer: 


As shipped After using 
NETCONFG 
LPT1 VPRN 
PRN VPRN2 
LPT3 LPT3 


3.2.2 How the Virtual Printer Works 


The virtual printer device accumulates characters in a character 
buffer that it writes, when the buffer is full, to a volume it has 
created in the //SYSTEM/QUEUE/TMP directory on the file 
server. Because DOS cannot tell the printer driver when to close 
the virtual printer and flush the buffer, the driver must be closed. 
Closure will occur after 15 seconds of no activity or it can be 
done explicitly by using <Alt> 222 (on the numeric keyboard) or 
by sending <Esc> V.C to the virtual printer. 


When the driver is closed, the volume is moved to 
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HSYSTEM/QUEUE/NEW/MMDDHHMMSS.$nn 


after unmounting (nn is the station number in hex, and 
MMDDHHMMSS is the time the request was made). 


3.2.3 The Header 


In addition to the data buffer for accumulating characters to be 
printed, the virtual print driver has a buffer containing the header 
to be written at the beginning of the spooled volume. Initially the 
header buffer contains four lines: 


REQTYPE:PRINT 
STATION:$nn 
TITLELINE:NO 
SPOOLED:DATA 


Each is terminated with a carriage return. Do not enter a null 
line before a carriage return. Nuil lines may cause 
unpredictable behavior, and subsequent lines may not be 
entered as part of the header. 


3.2.4 Specifying Header Values for Spooled Requests 
Using NWCMDS or VPCMDS 


In order to send virtual printer escape sequences from the key- 
board, you must use the NWCMDS program (or the VPCMDS 
program). This program is installed after you boot your machine, 
and from then on it is available to you by typing a special char- 
acter (the “trigger” character) on your keyboard. 


In order to send an escape sequence, type the trigger character 
and wait for the command window to appear. If you are using 
VPCMDS, the prompt VPRINT: will be displayed in the window. 
If you are using NWCMDS, the colon will be displayed; and you 
must then type <F10> in order for the VPRINT: prompt to 
show. 


Once the VPRINT: prompt appears, you can type any of the 
escape sequences without the leading <Esc> V. Any of the 
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virtual printer header keywords can by typed, as well as the 
local commands (for example, .r to reset the header to its 
default or .c to close the virtual printer). 


Note that with the exception of .p (change pathname) and .c the 
escape sequences do not affect any currently open virtual print 
files. In order to guarantee that any escape sequence you type 
takes effect immediately, you should type .c to close the virtual 
print file and then type the escape sequences. 


For example, if you want to make ten copies of a report on a 
draft printer set up your default virtual printer to print one copy 
of a letter quality printer, type the trigger character to get the 
NWCMDS window, press the <F10> key to get the VPRINT: 
prompt, and type: 


VPRINT:.c closes the current virtual print file 
VPRINT:COPIES:10 requests ten copies 
VPRINT:SETUP:DRAFT requests the draft printer 
VPRINT:q escapes from the VPCMDS or 


NWCMDS window 


Now that you have set up your virtual printer to print ten copies 
on the draft printer, each time you send a report to the virtual 
printer it will print the ten copies. In order to reset the virtual 
printer to print a single copy on the letter quality, enter 
NWCMDS (or VPCMDS) and type: 


VPRINT:.c closes any currently open virtual print file 
VPRINT:.r resets the virtual print parameters to their 
defaults 


Note that if you change your virtual printer parameters a lot, you 
should periodically issue the .r command to reset the parame- 
ters. Otherwise, each change you make will be added to the 
previous changes and overfiow the virtual printer header buffer. 


For further information on VPCMDS, see section 5.6 of this 
manual. 
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3.2.5 Specifying Header Values for Spooled Requests: 
the SETPRINT Program 
The SETPRINT program allows the user to specify header items 
and write them directly to a virtual printer or to a file for use 
later. 
To use the program, type 
C:SETPRINT 

(assuming that the shared network library volume is mounted on 
drive C:). You may also access SETPRINT through the Utility 
Program Menu. 
SETPRINT allows you to specify either a virtual printer or setup 
file. Enter the name of the virtual printer or output (setup) file to 


receive these header items. Default is LPT3 (the virtual printer). 


Available header items are: 


Header Page ID Priority 

User Name Page Title 

Print Server Page Numbering (yes/no) 
Printer Model Eject 

Printer Setup Copies 


These parameters and their defaults are defined in Section 
3.2.6. 


When finished, press <Esc>. You will be asked if you wish to 
save the parameters as entered. Type "Y". 


If you save the parameters to a file (called EXAMPLE, for 
instance) and subsequently type 


C:SETPRINT EXAMPLE 


the parameters saved will be used as defaults in the SETPRINT 
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menu. In this way you can create and save multiple header files, 
which you can copy to the virtual printer later, as needed, using 
SETPRINT or the command 

COPY filename LPT3 


(or, instead of LPT3, some other virtual printer name). 


3.2.6 Header Items 

Most header items can be specified using the SETPRINT pro- 
gram. To change a header item not handled by SETPRINT, 
such as TAG or DATE, you must send explicit instructions to the 
virtual printer using escape sequences. See Section 3.2.7. 
Some escape sequences change the header. When the virtual 
print file is opened, the current contents of the header, followed 
by an extra carriage return (null line), are moved to the data 
buffer to be written as the initial part of the file. After the virtual 
print file is closed, the header remains as is until changed by 
subsequent escape sequences. 

Keyword:value 

REQTYPE:PRINT {required] 


This must be the first line of the request. 
ID:<name> [optional] 
<name> will be printed in block letters on the header page. 


Maximum length is 15 characters. 


USER:<name> [optional] 


Will be printed as ID name if ID is not specified. 
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40 PRINT #2,"This prints virtually.” 

50 PRINT #2,CHRS$(27);"V.C": REM closes virtual 
printer 

60 END 


Note: If a colon follows the device name in line 20, either a “Bad 
file number” or a "Device unavailable” error message will appear 
when the BASIC program runs. 


3.2.8 Automatically Closing the Virtual Printer 


The virtual printer is set up to close automatically after 15 
seconds. The length of time before the printer closes can be 
changed using NETCONFG. It can also be disabled, in which 
case the printer must be closed explicitly. 


3.2.9 Closing the Virtual Printer from the Keyboard 


As an alternative to the ESC V .C <Return> sequence or while 
waiting for the virtual printer to timeout, the virtual printer can be 
closed from the keyboard, regardless of the program currently 
executing. 


The virtual printer driver looks at all keys read from the key- 
board to check for a special “close” key to close the virtual 
printer. To close the virtual printer, hold down the <Alt> key 
and type "222" on the numeric pad ONLY. Then release the © 
<Alt> key. This returns an ASCII code of 222 decimal, $DE 
hexadecimal (a code which can be produced in no other way 
from the keyboard). 


Note: <ALT> 222 is only active on a printing device con- 
figured as LPT1 or PRN. 


The virtual printer driver intercepts this key and closes the pend- 
ing virtual print. This method of closing is especially useful with 
the <Shift><PrtSc> (Print Screen) function to take a 
"snapshot" of the current screen. Type <Shift><PrtSc> and 
allow the cursor to scan the entire screen, then depress <Alt>, 
type 222 on the numeric pad, and release the <Alt> key. 
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In response to the "<Alt> 222" entry, the virtual printer will flush 
its buffer, unmount the temporary volume, move it to the Print 
Server's "new" queue, and mark the previous print closed. The 
next character buffered will re-open the virtual printer. If errors 
are encountered in the closing process, (if, for example, the 
MOVE command has failed), a beeping noise is produced, and 
the virtual printer is marked as closed. 
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PAGES 
3-23 THROUGH 3-34 


HAVE BEEN DELETED 
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3.4 Local Printers 
3.4.1 Before Using Your Local Printer 


Before using your local printer, make sure that the proper printer 
interface card is installed in your IBM PC computer. The 
appropriate printer driver code must be installed on your boot 
disk. 


You must also reconfigure your network driver. As distributed, 
the network driver includes a virtual printer device named LPT1 
(alias PRN). The names LPT1 and PRN are normally used by 
non-networked DOS to refer to local printers. Therefore local 
printers are not accessible with the driver as shipped. 


The virtual printer device can be renamed VPRN (alias VPRN2) 
with the NETCONFG program (discussed in Section 3.4.2). 
With this change the names LPT1 and PRN refer to the local 
printer (if present), and both local and virtual printer devices will 
be accessible. 


Note: The <Shift><PrtSc> and <Ctri><PrtSc> keys always 
print on LPT1 (whether local or virtual). 
3.4.2 Using NETCONFG to Rename the Virtual Printer 


Device 


NETCONFG.EXE is distributed on /MAIN/LIB/IBMPC/DOS. To 
access the NETCONFG program, type 


C: NETCONFG 


assuming that your library volume is mounted on drive C:. 
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You will be presented with a menu that allows you to update 
various parameters. The parameter you are concerned with is 


DEVICE NAME OF VIRTUAL PRINTER (DEFAULT LPT1) 
Type in 

VPRN 
(alias VPRN2). 
NETCONFG can also toggle VPRN (and VPRN2) back to LPT1 
(and PRN). Use the same steps outlined above except type in 
"LPT1". 
3.4.3 Using NETCONFG to Disable <Alt> 222 
Some communication programs will not work because of the 
checks made for <Alt> 222 by the virtual printer. NETCONFG 
can be used to cause the virtual printer not to check for 


<Alt>222. The parameter involved is 


DISABLE <Alt> 222 CHECK (default enable) 


3.4.4 Using Both Local and Virtual Printers 
If your network contains a virtual printer and a local printer, you 
will need to reconfigure your network driver using NETCONFG 
to access both printers. See Section 3.4.2. 
To get a printout from your local printer, use the command 
COPY filename LPT1 (or PRN) 
To get a printout from your virtual printer, use the command 


COPY filename VPRN (or VPRN2 or LPT3) 


See Figure 3-3. 


3-36 


E 


PRINTING 


3.4.5 Using A Local Printer Only 


To use a local printer only, you will need to reconfigure your net- 
work driver using NETCONFG. See Section 3.4.2. 


To get a printout, use the command 
COPY filename LPT1 (or PRN) 
See Figure 3-4. 
if NETCONFG is not used to reconfigure the driver, output to 


LPT1 will be spooled. If no print server is present in your net- 
work, the output will never be printed. © 


Figure 3-4 


Local Printer Only 
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Chapter 5 


Additional Utilities 


5.0 Introduction 


In addition to the NET program (Section 2.3), the network pro- 
vides a number of utility programs for use at the individual net- 
work stations. Before attempting to execute them, check for the 
names of the volumes on which they reside at your installation 
(usually a volume called /MAIN/LIB/IBMPC/DOS). 


STARTUP executes a file of commands on the user's default 
volume at initialization time. 


TCOPY allows the user to copy text files on Type=! virtual 
volumes to and from Type=T network text volumes. 


COUNT allows the user to analyze network activity by counting 
packets sent by stations on the network. 


NEST allows the user to direct file server response codes to the 
DOS condition ERRORLEVEL instead of to the workstation con- 
sole screen. 


NWCMDS allows access to the network and virtual printer from 
within any program environment via a scrolling window which 
appears on your screen. 


VPCMDS —a subset of NWCMDS—allows access to the virtual 
printer from within any program environment via a scrolling win- 
dow which appears on your screen. 


CARDCHK is used to test for and diagnose problems in PLAN 
Series IBM PC Network Interface Cards. 


NEWUSER enrolls a first time user on the network and creates 


a personal work space on the network disk. See Section 
1.11.2.1. 
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SETPRINT allows you to specify header items and write them 
directly to a virtual printer or to a file for use later. See Section 
3.2.4. 


NETCONFG modifies the parameters in the network driver. See 
Section 1.12.6. 


5.1 STARTUP Command Program 


STARTUP is a facility that allows users to issue file server com- 
mands automatically. This allows automatic configuration of the 
user's environment for user convenience or to provide a “turn- 
key" system. 


Note that for stations that boot from a virtual volume the use of 
STARTUP is not typically needed since most of its capabilities 
exist in the BOOT program. Because STARTUP is a large pro- 
gram, eliminating it from the boot process can speed booting 
considerably. STARTUP is useful when booting from local 
(Real) disks. 


STARTUP is usually invoked by having AUTOEXEC.BAT on 
drive A: with the following contents: 


NEST MOUNT //USERS/GEORGE/1,E:,RW 
E: 

NEST MOUNT //LIB/IBMPC/DOS,L:,RO,SHR 
L: STARTUP STARTCMD 


This sets the default drive to E: and then runs L:STARTUP to 
read commands from the text file called E:STARTCMD. 


STARTUP reads commands from the filename specified in the 
command line when STARTUP is called. If no filename is speci- 
fied, it attempts to read the STARTCMD file from the current 
disk. 
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5.2 TCOPY 
TCOPY is a utility used to transfer text files from one environ- 
ment to another. It is used to copy text files from the current 
environment into Type=Text volumes and to copy Type=Text 
volumes (perhaps created by TCOPY in some other environ- 
ment) into text files in volumes in the current environment. To 
execute the program, run TCOPY, found on the shared library 
volume, by typing "L: TCOPY" (assuming the library volume is 
mounted on drive L:). TCOPY may also be accessed from the 
Utility Program Menu. 
TCOPY will start by asking the question: 

Is the source a D(OS file or a N(etwork volume? 
Type "D" or "N" depending on which direction you wish to copy. 
The volume containing, or to contain, the Pascal file must be 
currently mounted; it must be mounted Read/Write if it is to be 
the destination volume. 
If the source is a DOS file. the program will then ask: 

Source file name: 


to which you should type the name of the source DOS file in 
standard DOS format, that is, [drive:]filename[.ext]. 


Note: The source file should always be a text file, not a code, 
binary, or data file. 


The program will then ask: 
Destination volume name: 


to which you should type the network pathname of the volume 
to which the source file will be copied. 


TCOPY will then ask: 


Replace destination [N]? 


Rev. 3/1/86 5-7 


TCOPY 


A response of "Y" causes the destination volume to be replaced 
by the contents of the source if the destination exists. If the des- 
tination volume does not exist, it will be created. "N" causes an 
error message if the destination volume exists. Pressing 
<Return> is the same as typing "N”. 


if the destination is a pre-existing network volume that will be 
replaced, any passwords or non-default access rights on the ori- 
ginal volume will be transferred automatically to the new 
volume. The size of the new volume will be the larger of the old 
and new volume sizes. 
TCOPY then asks: 

Delete source [N]? 
if "Y" is entered, the source file will be deleted when the copy is 
completed. Otherwise the source will be kept. Pressing 
<Return> is the same as typing "N". 
TCOPY will then copy the contents of the source file to the 
Type=T (Text) volume. A period (.) is printed for each line 
copied. When the copy is complete, the program will exit. 
If the source is a network volume, TCOPY asks: 

Source volume name: 


The name must be the pathname of a Type=T (Text) volume on 
a file server disk. TCOPY then asks: 


Destination file name:: 


Type the name of the DOS file to which the source volume will 
be copied. 


Note: The destination file should always be a text file, not a 
code, binary, or data file. 


TCOPY then asks: 
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5.2.2 TCOPYing from the Keyboard 
You can use TCOPY to type text from the workstation keyboard 
directly into a network volume (in much the same way you 
would use the DOS "COPY CON: filename” command to type 
text into a DOS file. 
To do so at the DOS prompt, type E> TCOPY 
Answer the "D(OS file or N(etwork volume” prompt with "D". 
When prompted for the source file name, enter 

User 
Reply to the prompt 

Replace destination [N]? 
with "Y" or "N". To the prompt 

Delete source [N]? 
press <Return>. 
Next enter the text to be placed in the T=T volume. After each 
<Return> that you enter, TCOPY will place a period at the start 
of the next line to signify that the previous line has been pro- 
cessed. 
Terminate your input by pressing <Ctri> Z or function key 6 
(F6). 
5.2.3 TCOPYing from a Text Volume to Your Screen 
Answer the "D(OS file or N(etwork volume" prompt with "N". 
Specify source volume when prompted. When prompted for the 


destination file name, enter "user" or "con". In response to the 
prompt "Replace destination [N]?", you must type "Y". 


COUNT 
5.3 COUNT 


The COUNT network monitor program tabulates network activity 
and displays the data in two screens. (If you have multiple 
fileservers, it can be a useful tool in balancing the network load 
among the fileservers.) COUNT can be accessed from the distri- 
buted library volume by typing L: COUNT (assuming that the 
shared library volume is mounted on drive L:). It can also be 
accessed from the Utility Program Menu. 


COUNT's two screens are arranged in the following four figures: 


(1) A moving skyline graph that shows how many packets per 
second the network has carried for the last 70 seconds. 
(Figure 5-1) 


(2) A bar graph that displays the amount of time taken for the 
token to traverse the network. (Figure 5-2) 


(3) A matrix of station addresses that displays stations on the 
network and their degree of activity. (Figure 5-3) 


(4) A bar graph that displays how many packets per second 
the network is carrying. (Figure 5-4) 


5.3.1 Skyline/Token Timing Screen 


When the user invokes COUNT, the program calibrates itself for 
several seconds. It then displays a screen which includes the 
skyline graph and the token timing graph and starts up the sky- 
line graph. Only one of these two graphs can function at a time. 


The skyline graph comprises the upper part of the screen. Every 
second a vertical bar is drawn corresponding to the number of 
packets (up to 1000) the network has carried during that 
second. Because the graph is shifted to the left each second, it 
presents a record of the amount of network activity that has 
occurred for the past 70 seconds. 


The horizontal axis represents time. The vertical axis measures 
the number of packets sent. In the sample screen below a peak 
of 700 packets occurred sixty seconds ago, and the network 
activity has since fallen to 100 packets each second. 


5-12 Rev. 3/1/86 


NWCMDS 


5.5 NWCMDS (Network Commands) 


NWCMDS allows access to the network from within any pro- 
gram environment. 


By simply striking a designated trigger character— <Ctri> F 
unless otherwise specified— your running program will be 
suspended and a scrolling window that can move to any position 
on the screen will appear. The window allows you to send com- 
mands to a file server or a virtual printer. Your commands and 
the server responses appear in the window. When your com- 
mands have been successfully executed, close the window by 
typing Q or the trigger characer. The: window then disappears 
and the running program resumes. 


Note: NWCMDS does NOT work with programs that set the 
graphics screen to bit graphics mode. it only works with 
programs that set the color graphics card to character 
mode. 


5.5.1 Installing NWCMDS 


NWCMDS.COM is distributed on the shared library volume 
iMAIN/LIB‘/IBMPC/DOS. 


NWCMDS can be installed manually or automatically. 


(1) For manual installation of NWCMDS, access the Nestar 
Main Menu and select the PLANPak Applications option. 
From the subsequent menu, select the Network Utilities 
programs option, and further select the NWCMDS option. 


NWCMDS needs to be manually installed each time your 
machine is rebooted. 


(2) For automatic installation, simply include the command 
L:NWCMDS 
plus any optional installation parameters (see Section 


5.5.1.2) in your AUTOEXEC.BAT file. "L:" in the above 
command should be included only if the DOS command 
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PATH has not been set to include drive L:. 


The AUTOEXEC.BAT file exists on whatever drive your 
work volume is mounted on. 


(3) Drive A: or C: if your profile mounts the library volume on 
drive L: and boots your work volume on drives A: or C:. 


>BOOT DOS3.0 ON C: 

MOUNT /MAIN/USERS/CRAIG/DOS3.0,C:,RW 
MOUNT /MAIN/LIB/IBMPC;DOS,L: 

BOOT C: 


(4) Drive E: if your profile boots the library volume on drive C: 
and mounts your work volume on drive E:, DOS will look for 
the AUTOEXEC.BAT file on drive E:. 


>BOOT DOS LIBRARY VOLUME 

MOUNT ;MAIN/USERS,CRAIG/DOS3.0,E:,RW 
MOUNT /MAIN/LIB/IBMPC;/DOS,C: 

BOOT C: 


Each time you reboot your machine and execute your profile, 
NWCMDS is automatically installed. 


When invoked for installation, NWCMDS transiently requires 
approximately 50K bytes. NWCMDS actually consists of approx- 
imately 5K bytes of code plus whatever space is necessary to 
save the pages of the screen window. If defaults for all parame- 
ters are used, NWCMDS requires approximately 11K bytes of 
space after it has been installed. 


5.5.1.1 /MAIN/SYSTEM/NAMES Volume 


NWCMDS can be made to understand both the symbolic name 
and the station address of any file server. 


To direct a command to a file server by its symbolic name, you 
will need to create at your workstation (with the use of an editor) 
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a shared Type=T volume called 
/MAIN/SYSTEM/NAMES 


Define the station addresses and names of all file servers as, 
for example, 


FS,Station=$FE,Name= Butler 


Then TCOPY the file to the newly created volume 
iMAIN/SYSTEM/NAMES. Once the NAMES volume is created, 
NWCMDS finds and reads it, and the names are stored within 
NWCMDS. (See Section 5.5.2.1.) 


5.5.1.2 Optional Installation Parameters 


Several optional parameters can be specified when NWCMDS is 
installed. These parameters can appear in any order in the 
NWCMDS command line and should be separated from each 
other and NWCMDS by one or more spaces. Upper and lower 
case letters are equivalent. Numerical values can be specified in 
decimal, or in hexadecimal if preceded by a dollar sign ($). 


KEY n 


The trigger character is used to invoke the NWCMDS program, 
and this parameter sets the character to be an ASCII character 
whose value is the number n between 0 and 127. 


To use the trigger character, select an obscure control character 
or special graphic, rather than commonly used letters or 
numbers . The character selected as the trigger character can- 
not be used for any purpose other than to open and close the 
NWCMDS window. For instance, if you attempt to enter that 
character as input to a running application program, it will invoke 
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the NWCMDS window instead. 
For example, the command 

NWCMDS KEY 7 
will change the trigger character from the default <Ctrl> F to 
<Ctrl> G. 
KEY On 
This parameter sets the trigger character to be a non-ASCII 
extended function key. "n” can represent a number between 0 
and 255 as documented in the IBM PC Technical Reference in 
the "Keyboard Extended Functions” table. 
For example, specifying 


NWCMDS KEY 0 104 


will change the trigger character to <Alt> F1. 


KEY Fn 


This parameter sets the trigger character to be one of the ten 
function keys. "n" can represent a number between 1 and 10. 


For example, the command 
NWCMDS KEY F8 


changes the trigger character to the F8 function key. 


WINDOW row1 col1 row2 col2 
This parameter specifies the size and position of the network 


command window on the screen. "Row1, col1” indicates the top 
left corner of the window and "row2, col2” indicates the bottom 
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Figure 5-5 


NWCMDS Window 


CMDS 1, 


Network Commands 





Lines which scroll out of the top of the window are saved in 
pages which can be viewed by using the <PgUp>, 
<PgDn>,<Home>, and <End> keys. The most recently 
issued commands and responses will appear at the bottom of 
the last page, which can be reached by striking the <End> key. 
Up to 8 pages of scrolled material can be saved. See Section 
5.5.1.2. 


The NWCMDS window can be moved to any position on the 
screen by pressing <shift> and the appropriate <arrow> key. 
The window will stay in this position until moved again or until 
NWCMDS is re-installed wherein the window will take the 
default position or the position defined in the "WINDOW" param- 
eter. 


NWCMDS supports the same function key editing provided for 


DOS commands. For more details, see the IBM DOS Version 
3.10 Reference. 
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To close the NWCMDS window, press the trigger character or 
enter "Q" (upper or lower case accepted) and press <Return>. 


5.5.2.1 File Server Commands 


Once the NWCMDS window is open, commands to the default 
file server can be issued. For example, during an editing ses- 
sion, you wish to mount a new volume on which to write the 
edited file to. Simply type in the command: 


MOUNT //USERS/LJS/TIMING,G:,UPD 


The network prompt (:) appears if the command has been suc- 
cessfully executed. Otherwise, you will receive an error mes- 
sage. 


Once the file server has executed your command, press "Q" or 
<F10> and <Return> to close the window. 


To issue commands to other file servers, use the command 


@$nn 
or 
@NAME 


where nn is the file server address and NAME is thefile server 
name as defined in the Type=T volume //SYSTEM/NAMES. 
For more details, see Section 5.5.1.1. 


NWCMDS will not accept local NET commands (including INIT) 
(see Section 2.6). 


NWCMDS will accept all of the file server commands as well as 
the local commands starting with @, ?, or !. 


When invoking NWCMDS while running an application pro- 
gram, avoid changing default file servers or unmounting 
volumes being written to or containing the application pro- 
gram itself. 
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5.6 VPCMDS (Virtual Printer Commands) 


VPCMDS allows access to the virtual printer from within any 
program environment. 


Note: VPCMDS does NOT work with programs that set the 
graphics screen to bit graphics mode. it only works with 
programs that set the color graphics card to character 
mode. 


By striking a designated trigger character, <Ctri>F unless oth- 
erwise specified, your running program will be suspended and a 
scrolling window will appear. Within the window, the prompt 
VPRINT: indicates that you may type a command line to be sent 
to the network virtual printer; the command is automatically pre- 
ceded by the escape sequence <Esc> V. See Chapter 3 for 
more on sending information to the virtual printer. 


For example, you may need to change the priority for your next 
virtual print job. Press the VPCMDS trigger character, <Ctrl> 
F, and the VPCMDS window will be displayed with the VPRINT: 
prompt. Then type “priority:high" <Return> to cause that line to 
be stored in the virtual printer header. Then press <Ctrl> F 
again to close the VCPCDS window. The next virtual print job 
will then be submitted as a high priority job. 


Or, if you wish to reset the header, simply type .r when the 
VPRINT: prompt is displayed. Remember that <Esc> V has 
been automatically prepended to your command. 


VPCMDS contains a subset of the functions of NWCMDS and is 
useful in a controlled environment where access to network 
fileserver commands is to be restricted. The installation instruc- 
tions and error messages for NWCMDS apply also to VPCMDS 
with the exception that the NAMES volume //SYSTEM/NAMES 
is not required or used by VPCMDS. See Section 5.5.1. 


For information on sending to the virtual printer using VPCMDS, 
see Section 3.2.4. 
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5.6 CARDCHK 


CARDCHK is designed to test IBM Network Interface Cards 
(NICs) in all allowable configurations. It consists of various dif- 
ferent test routines, each test being selectable so that any parts 
not present on any given NIC can be ignored. The section 
assumes that the user is familiar with the theory of operation of 
the NIC as described in Chapter 2 of the PLAN Series 
CARDCHK Utility Program and NIC Theory of Operations for 
the IBM PC Manual. Chapter 2 includes a functional descrip- 
tion, circuit diagrams, and decoder PROM listings. 


The utility, as supplied, contains all the software that is required 
to test a NIC, although two machines are required to run a com- 
plete NIC test. The first machine contains the NIC under test, 
running the test options. The second machine (containing a 
known good NIC) runs a program option called the ECHO 
SERVER. The two machines’ NICs are connected by a length of 
standard coax cable (RG62). The ECHO SERVER is used to 
test a NIC’s ability to talk to another station over the network 
link. The host machines sunning the test software can be any 
combination of IBM personal computers. (The two machines can 
be part of an active network, but this is not recommended.) 


The software is designed to be “user friendly", leading tr2 user 
through the required setup parameters and giving helpful error 
messages to use when debugging a board fault. Additional 
information on error message fault indications is provided in 
Section 5.6.3. 


The CARDCHK program is designed to test one NIC at one 
time. Should more than one card be inserted in a machine, the 
results are unpredictible. 


5.6.1 Running the Program 
To begin, make sure that the two machines to be used in the 
testing are configured correctly. Both machines need 128 kbytes 


of RAM. The machine that is to be the ECHO SERVER must 
have a known good NIC with its station address set to be 


5-34 


CARDCHK 


different from ANY that will be used in the NIC under test. The 
NIC in the ECHO SERVER can be attached to a standard 
BNC/BNC cable, but for exhaustive testing should be attached 
to a length of cable that has an attenuator (180 ohm resistor) in 
series with it, or a 4 port passive HUB connected in series with 
it (to check the threshold levels of the driver/receiver circuitry 
during testing). Insert the NIC to be tested in the machine used 
to test the NICs and connect the NIC to the other side of the 
attenuator or passive HUB via coax cable. 


The two machines can be part of an active network, but it is not 
recommended. Certain CARDCHK tests will cause excessive 
reconfigurations, which may disrupt the network. In addition, 
problems in intervening hubs and cabling may confuse test 
results. (On the other hand, if CARDCHK runs without errors on 
a station that is part of a network, there is no such confusion. 
Some system managers may find it most convenient to use two 
stations on the network, isolating the machines only if errors are 
encountered.) 


CARDCHK can be accessed from the Utility Program Menu, or 
you can run the software by , typing "L:CARDCHK" (assuming 
that the shared DOS library volume is mounted on drive L:) 


If you need to run CARDCHK from a standalone computer, 


(1) boot DOS 2.1 or higher, 

(2) insert a floppy containing CARDCHK, 
(3) log on to that drive 

(4) type CARDCHK (Return) 


The program will search for a NIC residing in the machine. If no 
card is found (either being absent, incorrectly addressed in the 
memory map, or faulty), an error message will be displayed and 
the program can be aborted, allowing the error to be corrected, 
or permitted to continue assuming the default value base 
address ($D200). This procedure allows the user to test a board 
with a defective ROM in it. 


The test menu gives the user the opportunity to select the 
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ECHO SERVER option or any combination of the eight test 
options. Turn one of the test machines into an ECHO SERVER 
by selecting option 9. 


The ECHO SERVER allows you to confirm that the station to be 
checked and the known good station are communicating with 
each other. Selecting the ECHO SERVER will cause a matrix to 
be displayed: 


ECHO SERVER: Press any key to return to main menu. 


Second Digit 
0123456789 ABCDEF 
0 0 0 
1 1 1 

F 2 2 2 
i 3 3 3 
r 4 4 4 
s 5 5 5 
t 6 6 6 
7 7 7 
d 8 8 8 
i 9* 9 9 
g A A A 
i B B B 
tC C” C 
D D D 
E E E 
F F F 
0123456789 ABCDEF 


The matrix will show which stations are sending packets to be 
echoed. A non-blank cell shows that some packets have been 
echoed. A cell that is changing shows ongoing activity. Station 
$FO is in the lower left corner, $0F is in the upper right. The 
screen above shows that stations $90 and $C8 are active. 


The test options selected will depend to some extent on the type 
of card being tested and on the degree of testing required. For 
PLAN 2000 NICs, the USER RAM and the PIT (Programmable 
Interval Timer) may have been removed, so these options 
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Network Usage: DOS 2.10 and 3.10 


B.1 [Reserved for future use] 


B.2 [Reserved for future use] 
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B.3 DOS 2.10 and DOS 3.10 Compatability 


Since some software packages do not work under DOS 3.10, 
both DOS 2.10 and DOS 3.10 can be used simultaneously at 
different workstations. Volumes INITed while in DOS 2.10 can 
be read and written while in DOS 3.10. Volumes INITed while in 
DOS 3.10 can be read and written while in DOS 2.10. 


Note that programs distributed on the DOS 2.10 library volume 
will not run under DOS 3.10. However, programs distributed on 
the DOS 3.10 library volume will run under DOS 2.10 or 3.10. 


Another difference occurs when INITing a boot volume with the 
SYS option (see Section 2.4). If the currently employed drive 
contains DOS 2.10 when the INIT command is given, the new 
volume will boot into DOS 2.10. If the currently employed drive 
contains DOS 3.10 when the INIT command is given, the new 
volume will boot into DOS 3.10. The volume can be read or writ- 
ten while booted (from another volume) into either version of 
DOS, but when booted, the version of DOS available is the one 
on that volume. 


WARNING: Do not use the SYS command to copy DOS 3.10 
onto a DOS 2.10 volume. If this procedure is used, the 
volume will NOT be bootable. Such is true for both hard 
disks and virtual volumes. A new volume should be INITed 
with the SYS option, then the files should be copied from 
the old volume to the new volume. 
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3.4.5 Using A Local Printer Only 


To use a local printer only, you will need to reconfigure your net- 
work driver using NETCONFG. See Section 3.4.2. 


To get a printout, use the command 
COPY filename LPT1 (or PRN) 
See Figure 3-4. 
If NETCONFG is not used to reconfigure the driver, output to 


LPT1 will be spooled. If no print server is present in your net- 
work, the output will never be printed. 


Figure 3-4 


Local Printer Only 







copy filename 
LPT1 (or PRN) 
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3.5 Tracking Print Requests with PRINTQ 


PRINTQ is a queue management program that allows you to 
inspect and maintain queued print requests. It runs on a user 
station independent of the print server. 


When PRINTQ is called up, it looks for the volume 
iMAIN/SYSTEM/NAMES on the current default file server. If this 
volume is not found, PRINTQ displays the message: 


Can't Read Configuration Volume! 


and exits. ,MAIN/SYSTEM/NAMES must exist for PRINTQ to 
run. For more information on this volume, refer to Chapter 6 in 
the PLAN 1000 Print Server Installation and Operation Manual. 


If a file server specified in ;MAIN/SYSTEM:/NAMES does not 
respond to an initial command that PRINTQ issues, PRINTQ 
displays a warning message, marks the file server off line, and 
attempts no further communication with that file server for the 
rest of its execution. 


PRINTQ locates existing print servers by examining all locks at 
all attached file servers. To qualify as a print server to PRINTQ, 
a station must hold SERVER, SERVER.PS, and NAME.<print 
server name>. 


To access PRINTQ, select the PRINTQ option from the PLAN- 
Pak Utility Menu or type: 


PRINTQ 


(If this doesn't work, type <drive #>:PRINTQ where drive # is 
the drive where the DOS library volume is mounted.) 
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After it is initialized, the PRINTQ main menu is displayed on the 
screen. The available options, displayed on the left-hand side of 
the screen, are: 


F1 


F2 


F3 


F4 


Update queue display 


Suspend queue display 
(currently updated every minute) 


Display requests of one user 
(currently ALL) 


Examine highlighted request 
with option to cancel 


To select an option, press the appropriate function key on the 
keyboard. For instance, if you want to update the queue 
display, press <Fi>. 


To exit PRINTQ, press <Esc>. 
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3.5.1 The Main Menu 


The main menu is illustrated below. 


PRENTQ -- Print Queue Information & Management Version 1.0 
Copyright 1985, 1986 Nestar Systems, Inc. PLAN Server (TM) software 


Active Print Servers: LENNON 
WAITS DEMOPIK BUXTEHUDE 
Update queue display Tos BUX TEHUDE 
12:33:56 
Suspend queue display i FS Qnum User Status 
(currently updated every minute) : Bae 747 $50 Waiting 
746 $5D Waiting 
Display requests of one user : &12 xXROFF Waiting 
(currently ALL) : 625 XROFF Waiting 
41S XROFF Waiting 
Examine request : 609 XROFF Waiting 
with option to cancel . 728 $50 Waiting 
727 $50 Waiting 
718 NANCY Waiting 
700 $5D Waiting 
699 $5D Waiting 
676 $73 Waiting 
805 XROFF Waiting 
$1? DOUG Completed 
$16 DOUC Completed 
: 142 HJS Completed 
Se Exit PRINTQ : 14l HJS Completed 





When one minute has passed on the time clock (located below 
the the list of active print servers), PRINTQ re-reads the master 
queue(s) and updates the right half of the screen displaying the 
print requests. 


The right side of the screen reflects the combined master 
queues of all file servers included in the PRINTQ configuration 
volume. PRINTQ has all queues mounted and sorts queue 
entries in order of status (unqueued, waiting, active and com- 
pleted) and, within status, in order of timestamp. 
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3.5.2 Update Current Display 


This option updates the print request display immediately (i.e., 
instead of waiting a minute to update the screen, it is updated 
immediately). 


To select this option, press <F1>. 


3.5.3 Suspend Queue Display 


This option suspends the queue update for the user wanting to 
examine the currently displayed queue contents at his or her 
own leisure. 


To select this option, press <F2>. 


The display is suspended and <F2> becomes "Periodically 
update display” as illustrated below. 


SRH Suspend queue display 
(currently updated every minute) 


PRYNTQ -~ Print Queue Informacion & Management Version 1.0 
Cofyright 1985, 1986 Nestar Systems, Inc, PLAN Server (TM) software 


int Servers: LENNON 
DEKOP 1K BUXTEHUDE 
Update queue display BUXTEHUDE 
12:33:56 
Suspend queue display Date Time FS Qnum User Status 
(currently updated every minute) 4/09 : Bae 747 $5D Waiting 
4/09 : Bae 746 $50 Waiting 
Display requests of one user 4/08 : Ber 412 XROFF Waiting 
(currently ALL) 6/08 3 Ber 425 XROFF Waiting 
4/08 : Ber 4615 XROFF Waiting 
Examine request 4/08 : 409 XROFF Waiting 
with option to cancel 4/08 3 728 $50 Waiting 
&/08 : 727 $50 Waiting 
4/07 15: 718 NANCY Waiting 
4/07 : 700 $50 Waiting 
4/0) ? 699 $50 Waiting 
6/04 : 676 $?) waiting 
6/02 : 805 XROFF Waiting 
6/09 3 517? DOUC Completed 
4/09 : 516 DOUG Completed 
6/09 : 142 HIS Completed 
KEs€ Esir PRINTQ 4/09 12: 141 HIS Completed 





To exit the suspend option so the queue begins updating again, 
press <F2>. 
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3.5.4 Display Requests of One User 


This option displays the requests of one specific user (ALL is 
the default). 


nn 
To select this option, press <F3>. PRINTQ prompts "User to 
display”: 


User to display: 


Sate 


i to display all requests) 










PRINTF -- Print Queue Information & Management 
Copyrfghe i985, 1986 Nestar Systems, Inc. 








Version 1.0 
PLAN Server (TM) software 




















nt Servers: LENNON 
DEMOP1K BUXTEHUDE 





































BUXTEHUDE 
12:36:13 

Time FS Qnum User Status 

10:27 Bae 747 $5D Waiting lin, 

10:26 Bae 746 $50 Waiting / 

4 15:42 Ber 412 XROFF Waiting 
4/08 15:40 Ber 425 XROFF waiting 
6/08 15:34 Ber 413 XROFF Waiting 
4/08 15:28 Ber 409 XROFF Waiting 
o, 4/08 14:56 Bae 728 $50 Waiting 
( RE to display all requests) 4/08 13:26 Bae 727 $50 Waiting 
4/0? 15:11 Bae 718 NANCY Waiting 
4/07 10:57 Bee 700 $5D Waiting 
4/07 10:33 Bae 699 $5D Waiting 
4/04 9:54 Bae 676 $73 Waiting 
4/02 15:16 Ber 805 XROFF daicing 
4/09 12:33 Buc 143 NJR Completed 
4/09 12:31 Ber $17 DOUC Compleced 
4/09 12:29 Ber 516 DOUG Completed 
4/09 12:28 Buc 142 HJS Completed 
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Enter the userid for which you want requests displayed, e.g., 
YYS, followed by a carriage return, or press <Esc> to redisplay 
all requests. 


<F1> and <F2> become new options: 





Display only waiting and active 
requests of a single user 






SSE Display waiting active & completed 
requests of a single user 












PZINTQ -- Print Queue Information & Management 
‘Ppyright 1985, 1986 Nestar Systems, Inc. 






Version 1.0 
PLAN Server (TM) software 











Print Servers: LENNON 
DEMOPIK BUXTEHUDE 









E Display only waiting and active 

































BUXTEHUDE 
requests of a single user 12:36:39 

; Time FS Qnum User Status 
T% Display waiting active & completed 10:27 Bee 747 $5D Waiting 
requests of a single user 4/09 10:26 Bae 746 $5D Waiting 
4/06 15:42 Ber 412 XROFF Waiting 

4/08 15:40 Ber 425 XROFF Waiting 

4/08 15:34 Ber S415 XROFF Waiting 

4/08 15:28 Ber 409 XROFF Waiting 

4/08 14:56 Bae 728 $50 Waiting 

4/08 13:26 Bae 727 $50 Waiting 

4/07 15:11 Bae 718 NANCY Waiting 

4/07 10:57 Bae 700 $50 Waiting 

4/07 10:33 Bae 699 $5D Waiting 

4/06 9:54 Bae 676 $73 Waiting 

4/02 15:16 Ber 805 XROFF Waiting 

4/09 12:33 Buc 143 NIR Completed 

4/09 12:31 Ber 517 DOUC Completed 

4/09 12:29 Ber 516 DOUC Compleced 

6/09 12:28 But 142 HJS Completed 


Rev. 4/15/86 3-45 


PRINTING 


Select <F1> if you want only waiting and active requests to be 
displayed. Select <F2> if you want all waiting, active, and com- 
pleted requests to be displayed (the completion of this opera- 
tion is time consuming). 


3.5.5 Examine Highlighted Request 


This option allows you to obtain information about a specific 
print request. 


To select this option, press <F4>. PRINTQ will highlight the 
print request at the top of the list and display information about 
that request, for example: 
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EXAMINE Request 634 on FS Berlioz 





Active Print Servers: LENNON 
OEMOPIK BUXTEHUDE TDs 
BUXTEHUDE 





MASTER QUEUE ENTRY: 






11:04:45 
Date Time FS Qnum User 
RRE, 2 VE sy Br 






Status? waiting fur server 





Status 
De gy 5 ye YS GAE Se ERS 














































Note: Needs server JACCER 4/09 17:03 Ber 587 $81 Waiting 
4/09 17:02 Ber 586 Waiting 

Priority: high 4/09 10:27 Bae 747 $5D Waiting 
4/09 10:26 Bae 746 $5D waiting 

User: WENDY 4/08 15:40 Ber 425 XROFF Waiting 
4/08 15:34 Ber 415 XROFF Waiting 

Server: JAGGER 4/08 15:28 Ber 409 XROFF Waiting 
4/08 14:56 Bae 728 $5D Waiting 

Queued on: Date S/10 Time 9:22 4/08 13:26 Bae 72? $50 waiting 
4/07 15:11 Bae 728 NANCY Waiting 

9 Entry detail 4/07 10:$7 Bae 700 $50 Waiting 
$ 4/07 10:33 Bae 699 $50 Waiting 
Alc~P9. Cancel entry 4/06 9:54 Bae 676 $73 Waiting 
4/02 15:16 Ber 805 XROFF Waiting 

Bec: Return to Printgq menu G/10 11:06 Bir 74} IA LIST Active 
4/10 10:58 Ber 650 808 Completed 
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PRINTING 


The information PRINTQ displays about the request includes 


the status of the request (waiting, active, or completed) 


the reason why the request has the current status, for exam- 
ple, the request may be waiting because a file server is una- 
vailable 


the request's priority (high, standard, low, overnight) 
the user's name 

the name of the print server in the user's setup 
when the request was queued 


At this point you can cancel the highlighted request by typing 
<Alt><F9>, push <Esc> to return to the PRINTQ main 
menu, or move the highlight bar to another request. 


To move the highlight bar up and down the list of print requests 
to a request you want to examine, press <t> or <.>. Press 
<PgUp> or <PgDn> to move the highlight bar up or down 10 
lines. 


When you have the bar on the appropriate print request, press 
<F9> to display information about that request, <Alt><F9> to 
cancel the request, or <Esc> to return to the main menu. 


Note: You can use the examine request option after you have 
displayed the queue for a specific user. Thus you can select 
<F3> to display the requests of one user and then press 
<F4> to obtain more information about a specific request. 
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networked application programs (cont.) 
selecting 6-1 . 
setup and maintenance 6-13 
Startup 6-10 
from the DOS environment 6-11 
trying Out 6-2 
NETWORK.SYS 1-2, 1-38, 1-39 
NEWCMD 4-14 
NEWCMDFLAG 4-5, 4-6 
NEWS 5-4 
NEWUSER v, 1-33 thru 1-38, 5-1 
NIC 5-1, 5-15, 5-32, D-2 
NOCOLOR 1-23, 1-24 
NOECHO 1-7, 1-18, 1-19, 2-7, 5-3 
NSR 4-17 
NSRUNIT.ITF 4-22 
NWCMDS utility iv, 2-3, 2-8, 2-16, 3-9, 4-15, 5-1, 5-23, 5-32 
already installed 5-28 
bad color specification 5-29 
bad number of pages 5-29 
bad trigger character 5-29 
bad window specification 5-29 
L4 locate error 5-29 
LPT3 driver not found 5-30 
NCMD driver not found 5-30 
unrecognized operand 5-29 
window, Fig 5-5, 5-31 
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OFF A-3 
optional installation parameters 5-25 
OPTIONS 4-3 


p 


PAGES n 5-27 
Partial Tape Dump/Restore utility 2-24 
Pascal 4-2, 4-22 
PASCAL.LIB 4-2 
PASCAL programs 4-22 
PASSWORD 5-5 
passwords, profile 1-16, 1-17 
pathname 2-1, 2-9 
PAUSE 1-17 
personal work volume 1-4 
PIT test errors 5-43 
PLANPak II" 1-1, 6-1, 6-4, 6-8, 6-11, 6-15 
default drive 6-4, 6-8, 6-14 
memory requirements 1-1, 6-1 
menus 
accessing 6-1 thru 6-3 
from DOS environment 6-1, 6-2 
from startup 6-1 
POST.MM 6-14 
how to create your own 6-15 
primary 
file server 2-15 
changing 2-18 
volumes 2-19 
PRINT 1-18, 5-4 
<anystring> 2-7 
PRINTQ 3-40 
print request, tracking 3-37 
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